Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/chmln/handlr
A better xdg-utils
https://github.com/chmln/handlr
cli command-line dmenu linux rofi rust
Last synced: 9 days ago
JSON representation
A better xdg-utils
- Host: GitHub
- URL: https://github.com/chmln/handlr
- Owner: chmln
- License: mit
- Created: 2020-04-05T21:29:39.000Z (over 4 years ago)
- Default Branch: master
- Last Pushed: 2023-04-30T07:25:01.000Z (over 1 year ago)
- Last Synced: 2024-10-14T13:50:43.054Z (28 days ago)
- Topics: cli, command-line, dmenu, linux, rofi, rust
- Language: Rust
- Homepage:
- Size: 313 KB
- Stars: 630
- Watchers: 9
- Forks: 24
- Open Issues: 35
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
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
- Wildcard support like `text/*`
- 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
```sh
# 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 wildcard handler for all text files
handlr set 'text/*' nvim.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 fish, zsh and bash), including mimes, extensions, and `.desktop` files
- Optional json output for scripting
- Properly supports `Terminal=true` entries
## Setting default terminal
Unfortunately, there isn't an XDG spec and thus a standardized way for `handlr` to get your default terminal emulator to run `Terminal=true` desktop entries. There was a proposal floating around a few years ago to use `x-scheme-handler/terminal` for this purpose. It seems to me the least worst option, compared to handling quirks of N+1 distros or using a handlr-specific config option.
Now if `x-scheme-handler/terminal` is present, `handlr` will use it.
Otherwise, `handlr` will:
1. Find an app with `TerminalEmulator` category
2. Set it as the default for `x-scheme-handler/terminal`
3. Send you a notification to let you know it guessed your terminal and provide instructions to change it if necessary
On the upside, `Terminal=true` entries will now work outside of interactive terminals, unlike `xdg-utils`.
## 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
```
3) Now in this example when you open a URL, you will be prompted to select the desired application.
## Screenshots
## Installation
### Arch Linux
```sh
yay -S handlr-bin
```
Optionally you can also install `xdg-utils-handlr` to replace `xdg-open`:
```sh
yay -S xdg-utils-handlr
```
### Rust/Cargo
```sh
cargo install handlr
```
### Binaries
1. Download the latest [release binary](https://github.com/chmln/handlr/releases) and put it somewhere in `$PATH`
2. Download completions for fish:
```sh
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](https://creativebloq.com)