A better xdg-utils
Find a file
2020-05-17 17:51:10 -04:00
.github/workflows Add workflow 2020-05-17 16:01:50 -04:00
completions Combine mimes with extensions 2020-05-17 15:48:56 -04:00
src Remove rayon, deemed unneeded after benchmarks 2020-05-17 16:01:26 -04:00
.gitattributes Ignore completions from stats 2020-05-16 03:25:25 -04:00
.gitignore MVP 2020-04-05 17:29:58 -04:00
.rustfmt.toml Handle directories 2020-05-17 00:45:25 -04:00
Cargo.lock (cargo-release) version 0.2.0 2020-05-17 16:07:33 -04:00
Cargo.toml (cargo-release) version 0.2.0 2020-05-17 16:07:33 -04:00
README.md Update README.md 2020-05-17 17:51:10 -04:00


handlr

Manage your default applications with ease using handlr!

Features

  • Set default handler by extension or mime-type
  • Intelligent mime type detection from files based on extension and content
  • Mime-type validation against a massive database
  • List default associations
  • Automatically removes invalid/wrong .desktop entries from mimeapps.list
  • Helper commands like launch, get --json for your scripting needs
  • Unnecessarily fast (written in Rust)
  • Single compiled binary with no dependencies

Usage

# Open a file/URL
handlr open ~/.dotfiles/pacman/packages.txt
handlr open https://google.ca

# Set default handler for png files
handlr set .png feh.desktop

# Set default handler based on mime
handlr set application/pdf evince.desktop

# List default apps
handlr list

# Get the handler for a mime/extension
$ handlr get .png
feh.desktop

# Launch a handler with given path/URL
handlr launch x-scheme-handler/https -- https://google.ca

Compared to xdg-utils

  • Far easier to use with simple commands like get, set, list
  • Can operate on extensions, no need to look up or remember mime types
    • useful for common tasks like setting a handler for png/docx/etc files
  • Superb autocomplete (currently just fish), including mimes, extensions, and .desktop files
  • Optional json output for commands like get

Screenshots

Installation

While packages for distributions are pending,

  1. Download the latest release binary and put it somewhere in $PATH
  2. Download completions:
curl https://raw.githubusercontent.com/chmln/handlr/master/completions/handlr.fish --create-dirs -o ~/.config/fish/completions/handlr.fish

Alternatively, you can install with cargo:

cargo install handlr

Attribution

Icons made by Eucalyp from www.flaticon.com

Cover photo by creativebloq.com