A tool to help my sanity when opening http/s links.
Go to file
Emma Tebibyte a10f4a3ceb added more readme info 2022-09-21 22:03:02 -04:00
xdg-sanity added redirect handling 2022-09-05 21:33:31 -04:00
LICENSE initial commit 2022-09-01 22:17:23 -04:00
README.md added more readme info 2022-09-21 22:03:02 -04:00
xdg-sanity.sh added redirect handling 2022-09-05 21:33:31 -04:00

README.md

xdg-sanity

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.

Installation

Arch

I maintain a package on the AUR.

From Source

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. Make sure the installation location is in your $PATH.

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 that .desktop file.

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.