emma/xdg-sanity
1
1
Fork 0
Code Issues Pull Requests Releases 4 Activity

added more readme info

Browse Source
This commit is contained in:
Emma Tebibyte 2022-09-21 22:03:02 -04:00
parent e11e73d8a6
commit a10f4a3ceb
1 changed files with 13 additions and 7 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

20
README.md
View File

@ -3,7 +3,7 @@
The `xdg-sanity` script is built to replace your default web browser in your
desktop/XDG settings. It intercepts http/s URIs sent to the default browser by
`xdg-open` and sends it to the appropriate application. For example, it will
send image/jpeg MIME type files to your image viewer.
send `image/jpeg` MIME type files to your image viewer.
## Installation
@ -14,15 +14,21 @@ AUR](https://aur.archlinux.org/packages/xdg-sanity).
### From Source
First, make sure you have `curl(1)` and `handlr` installed. Then, clone this
First, make sure you have `curl(1)` and `handlr(1)` installed. Then, clone this
repository and move the `xdg-sanity/` folder into `/etc` and `xdg-sanity.sh` to
`xdg-sanity` wherever your operating system stores locally-installed binaries.
This is usually `/usr/local/bin`.
This is usually `/usr/local/bin`. Make sure the installation location is in your
`$PATH`.
Then, create a `xdg-sanity.desktop` file either manually or with `gendesk(1)`,
Create a `xdg-sanity.desktop` file either manually or with `gendesk(1)`,
placing it, also, where your OS stores locally-installed `.desktop` files,
usually `/usr/local/applications`. Set your default web browser to be that
usually `/usr/local/applications`. Set your default web browser to that
`.desktop` file.
Now, add your default web browser to `/etc/xdg-sanity/xdg-sanity.conf` so the
script can forward links to it.
Add your default web browser to `/etc/xdg-sanity/xdg-sanity.conf` so the
script can forward links to it.
### Usage
Open links from applications outside your web browser as normal. Alternatively,
you can call `xdg-sanity` directly with the only argument accepted being a URI.