From 81f63e9e4aadd4ead9c66d54356912fadbea8435 Mon Sep 17 00:00:00 2001 From: Gregory Date: Sun, 17 May 2020 16:10:45 -0400 Subject: [PATCH 01/10] Update README.md --- README.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index 158f63a..ff23eab 100644 --- a/README.md +++ b/README.md @@ -20,9 +20,9 @@ Manage your default applications with ease using `handlr`! ### Screenshots
- + - +
### Attr From c99fa5ad802486fb816bf15489e513188bcaf5c8 Mon Sep 17 00:00:00 2001 From: Gregory Date: Sun, 17 May 2020 16:13:51 -0400 Subject: [PATCH 02/10] Update README.md --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index ff23eab..f37a499 100644 --- a/README.md +++ b/README.md @@ -7,7 +7,7 @@ Manage your default applications with ease using `handlr`! - Set default handler by extension or mime-type - Open path/url with default handler (like xdg-open) - List default associations -- Automatically removes invalid/wrong `.desktop` entries +- Automatically removes invalid/wrong `.desktop` entries from `mimeapps.list` - Simply a great command-line experience ### Compared to `xdg-open` and `xdg-mime`: From b9ea62f26cb03af80a55ed992bc7d52142b2d020 Mon Sep 17 00:00:00 2001 From: Gregory Date: Sun, 17 May 2020 16:50:57 -0400 Subject: [PATCH 03/10] Update README.md --- README.md | 24 ++++++++++++++++++------ 1 file changed, 18 insertions(+), 6 deletions(-) diff --git a/README.md b/README.md index f37a499..1c987c9 100644 --- a/README.md +++ b/README.md @@ -2,7 +2,7 @@ Manage your default applications with ease using `handlr`! -### Features +## Features - Set default handler by extension or mime-type - Open path/url with default handler (like xdg-open) @@ -10,20 +10,32 @@ Manage your default applications with ease using `handlr`! - Automatically removes invalid/wrong `.desktop` entries from `mimeapps.list` - Simply a great command-line experience -### Compared to `xdg-open` and `xdg-mime`: +## Compared to `xdg-open` and `xdg-mime`: - 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 +## Screenshots
- + - +
-### Attr +## Installation + +Just download the latest [release binary](https://github.com/chmln/handlr/releases). + +--- + +Alternatively, you can install with `cargo`: + +```sh +cargo install handlr +``` + +#### Icon Attribution Icons made by Eucalyp from www.flaticon.com From ffdee0408d9d3e749a7e1c9de98b1c8da2b1d918 Mon Sep 17 00:00:00 2001 From: Gregory Date: Sun, 17 May 2020 16:51:10 -0400 Subject: [PATCH 04/10] Update README.md --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 1c987c9..27421d1 100644 --- a/README.md +++ b/README.md @@ -10,7 +10,7 @@ Manage your default applications with ease using `handlr`! - Automatically removes invalid/wrong `.desktop` entries from `mimeapps.list` - Simply a great command-line experience -## Compared to `xdg-open` and `xdg-mime`: +## Compared to `xdg-open` and `xdg-mime` - 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 From ea0b351bbb2df576b1bda254c906fae89ac5c8a6 Mon Sep 17 00:00:00 2001 From: Gregory Date: Sun, 17 May 2020 17:01:37 -0400 Subject: [PATCH 05/10] Update README.md --- README.md | 36 +++++++++++++++++++++++++++++++----- 1 file changed, 31 insertions(+), 5 deletions(-) diff --git a/README.md b/README.md index 27421d1..1e16ab5 100644 --- a/README.md +++ b/README.md @@ -5,18 +5,44 @@ Manage your default applications with ease using `handlr`! ## Features - Set default handler by extension or mime-type -- Open path/url with default handler (like xdg-open) +- 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` -- Simply a great command-line experience +- Helper commands like `launch`, `get --json` for your scripting needs +- Unnecessarily fast (written in Rust) +- Single compiled binary with no dependencies -## Compared to `xdg-open` and `xdg-mime` +## 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 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 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
@@ -37,5 +63,5 @@ Alternatively, you can install with `cargo`: cargo install handlr ``` -#### Icon Attribution +## Icon Attribution Icons made by Eucalyp from www.flaticon.com From fb1e2fdf3c14563fcad9c54217ca265d7b81776a Mon Sep 17 00:00:00 2001 From: Gregory Date: Sun, 17 May 2020 17:35:53 -0400 Subject: [PATCH 06/10] Update README.md --- README.md | 1 + 1 file changed, 1 insertion(+) diff --git a/README.md b/README.md index 1e16ab5..9acc8ef 100644 --- a/README.md +++ b/README.md @@ -38,6 +38,7 @@ 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 From 38e59ae457466db75d40a20a4a011dfa0f5f7bde Mon Sep 17 00:00:00 2001 From: Gregory Date: Sun, 17 May 2020 17:39:40 -0400 Subject: [PATCH 07/10] Update README.md --- README.md | 8 +++++++- 1 file changed, 7 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index 9acc8ef..d912bb1 100644 --- a/README.md +++ b/README.md @@ -54,7 +54,13 @@ handlr launch x-scheme-handler/https -- https://google.ca ## Installation -Just download the latest [release binary](https://github.com/chmln/handlr/releases). +While packages for distributions are pending, + +1. Download the latest [release binary](https://github.com/chmln/handlr/releases) and put it somewhere in `$PATH` +2. Download completions: +```sh +curl https://raw.githubusercontent.com/chmln/handlr/master/completions/handlr.fish --create-dirs -o ~/.config/fish/completions/handlr.fish +``` --- From 5c8484914bdb2267ac4fbd9cfa98b3a90b4a084d Mon Sep 17 00:00:00 2001 From: Gregory Date: Sun, 17 May 2020 17:42:16 -0400 Subject: [PATCH 08/10] Update README.md --- README.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/README.md b/README.md index d912bb1..599dec8 100644 --- a/README.md +++ b/README.md @@ -2,6 +2,8 @@ Manage your default applications with ease using `handlr`! +`handlr` is especially useful for window managers like i3 and bspwm that don't have DE-specific utils like `gvfs-open`, `kde-open`, etc. + ## Features - Set default handler by extension or mime-type From f7255061fe55dd00dc9122ca3cf027e919b8f01f Mon Sep 17 00:00:00 2001 From: Gregory Date: Sun, 17 May 2020 17:45:12 -0400 Subject: [PATCH 09/10] Update README.md --- README.md | 2 -- 1 file changed, 2 deletions(-) diff --git a/README.md b/README.md index 599dec8..d912bb1 100644 --- a/README.md +++ b/README.md @@ -2,8 +2,6 @@ Manage your default applications with ease using `handlr`! -`handlr` is especially useful for window managers like i3 and bspwm that don't have DE-specific utils like `gvfs-open`, `kde-open`, etc. - ## Features - Set default handler by extension or mime-type From 24910afe52b2fb09f203b6a91d0a8e8c811fc5aa Mon Sep 17 00:00:00 2001 From: Gregory Date: Sun, 17 May 2020 17:51:10 -0400 Subject: [PATCH 10/10] Update README.md --- README.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index d912bb1..9689c38 100644 --- a/README.md +++ b/README.md @@ -70,5 +70,7 @@ Alternatively, you can install with `cargo`: cargo install handlr ``` -## Icon Attribution +## Attribution Icons made by Eucalyp from www.flaticon.com + +Cover photo by [creativebloq.com](https://creativebloq.com)