troldspejlet/handlr
troldspejlet/handlr
1
0
Fork 0
mirror of https://github.com/chmln/handlr.git synced 2024-11-14 21:49:27 +01:00
Code Issues Projects Releases Packages Wiki Activity Actions

Update README.md

Browse source
This commit is contained in:
Gregory 2021-04-23 18:48:15 -04:00 committed by GitHub
parent 74bc905fab
commit 8910615321
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23
1 changed files with 19 additions and 3 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

22
README.md
View file

@ -7,8 +7,8 @@ Manage your default applications with ease using `handlr`!
- Set default handler by extension or mime-type - Set default handler by extension or mime-type
- Intelligent mime type detection from files based on extension and content - Intelligent mime type detection from files based on extension and content
- Open multiple files at once - Open multiple files at once
- Set multiple handlers for mime/extension and use rofi/dmenu to pick one - Set multiple handlers for mime/extension and use `rofi`/`dmenu` to pick one
- List default associations - Wildcard support like `text/*`
- Automatically removes invalid/wrong `.desktop` entries from `mimeapps.list` - Automatically removes invalid/wrong `.desktop` entries from `mimeapps.list`
- Helper commands like `launch`, `get --json` for your scripting needs - Helper commands like `launch`, `get --json` for your scripting needs
- Unnecessarily fast (written in Rust) - Unnecessarily fast (written in Rust)
@ -24,6 +24,9 @@ handlr open https://google.ca
# Set default handler for png files # Set default handler for png files
handlr set .png feh.desktop handlr set .png feh.desktop
# Set wildcard handler for all text files
handlr set 'text/*' nvim.desktop
# Set default handler based on mime # Set default handler based on mime
handlr set application/pdf evince.desktop handlr set application/pdf evince.desktop
@ -39,13 +42,26 @@ handlr launch x-scheme-handler/https -- https://google.ca
``` ```
## Compared to `xdg-utils` ## Compared to `xdg-utils`
- Can open multiple files/URLs at once - Can open multiple files/URLs at once
- Can have multiple handlers and use rofi/dmenu to pick one at runtime - Can have multiple handlers and use rofi/dmenu to pick one at runtime
- Far easier to use with simple commands like `get`, `set`, `list` - Far easier to use with simple commands like `get`, `set`, `list`
- Can operate on extensions, **no need to look up or remember mime types** - 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 - useful for common tasks like setting a handler for png/docx/etc files
- Superb autocomplete (currently just fish), including mimes, extensions, and `.desktop` files - Superb autocomplete (currently just fish), including mimes, extensions, and `.desktop` files
- Optional json output for commands like `get` - 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.
Because most users will not have this handler set up, `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 ## Setting multiple handlers