troldspejlet/handlr
troldspejlet/handlr
1
0
Fork 0
mirror of https://github.com/chmln/handlr.git synced 2024-11-14 13:39:29 +01:00
Code Issues Projects Releases Packages Wiki Activity Actions
A better xdg-utils
84 commits 1 branch 17 tags 328 KiB
Rust 99.5%
Vim Script 0.4%
Find a file
ftilde a009331856 Launch process in terminal emulator if required 
If a desktop entry requires a terminal, but the current process does not
run in one, the process would previously run invisibly in the
background. Now we instead start the process in a newly launched
terminal in that case. This is especially useful when (for example)
opening text files downloaded in a browser using the system open dialog.

For now the terminal emulator to be used is specified in the
configuration file. When/if there is a standard way to select the
terminal emulator, it is conceivable to use that method instead or if no
config item is present (see
https://gitlab.freedesktop.org/xdg/xdg-utils/-/issues/84).
2020-09-29 21:06:11 +02:00
.github/workflows Strip release binary 2020-05-22 19:55:16 -04:00
completions Cleanup 2020-06-12 14:45:25 -04:00
src Launch process in terminal emulator if required 2020-09-29 21:06:11 +02:00
tests Rely on a more robust entry parser | #9 2020-06-19 20:22:49 -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.4.5 2020-06-20 21:23:35 -04:00
Cargo.toml (cargo-release) version 0.4.5 2020-06-20 21:23:35 -04:00
README.md Update README.md 2020-06-19 20:46:30 -04:00

README.md


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
  • Open multiple files at once
  • Set multiple handlers for mime/extension and use rofi/dmenu to pick one
  • 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

  • Can open multiple files/URLs at once
  • Can have multiple handlers and use rofi/dmenu to pick one at runtime
  • 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

Setting multiple handlers

  1. Open ~/.config/handlr/handlr.toml and set enable_selector = true. Optionally, you can also tweak the selector to your selector command (using e.g. rofi or dmenu).

  2. Add a second/third/whatever handler using handlr add, for example

handlr add x-scheme-handler/https firefox-developer-edition.desktop
  1. Now in this example when you open a URL, you will be prompted to select the desired application.

Screenshots

Installation

Arch Linux

yay -S handlr-bin

Optionally you can also install xdg-utils-handlr to replace xdg-open:

yay -S xdg-utils-handlr

Rust/Cargo

cargo install handlr

Binaries

  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

Attribution

Icons made by Eucalyp from www.flaticon.com

Cover photo by creativebloq.com