yaxo.1

.TH YAXO 1 "2025" "yaxo manual"

.SH NAME
yaxo \- deterministic, config-driven replacement for xdg-open

.SH SYNOPSIS
.B yaxo
.I file | url

.SH DESCRIPTION
\fByaxo\fR is a modern, configurable XDG opener. It resolves how to open
files and URLs using a predictable, strict priority system:

.TP
1. User config rules (~/.config/yaxo.rc)
.TP
2. Desktop file MIME/URL handlers
.TP
3. default= command
.TP
4. launcher= fallback
.TP
5. xdg-open or gio fallback (URLs only)

yaxo never attempts to launch browsers for regular files, and never pauses
for interactive input like xdg-open.

.SH CONFIGURATION

The configuration file is located at:
.PP
\fI~/.config/yaxo.rc\fR

Entries follow the format:
.PP
\fBkey = command with {target}\fR

.SH RULE KEYS

.TP
\fBmime:<full>\fR
Matches full MIME type.

.TP
\fBmajor:<major>\fR
Matches MIME major group (e.g. text, image).

.TP
\fBminor:<minor>\fR
Matches MIME minor type (e.g. javascript, png).

.TP
\fBext:<ext>\fR
Matches file extension.

.TP
\fBtype:<type>\fR
Matches file, directory, symlink, executable.

.TP
\fBurl:<pattern>\fR
Wildcard matching for URLs.

.TP
\fBlauncher=<cmd>\fR
Last local fallback.

.TP
\fBterminal=<cmd>\fR
Command used for desktop entries with Terminal=true.

.TP
\fBdefault=<cmd>\fR
Fallback opener before launcher.

.SH DESKTOP FILE HANDLING

Desktop entries are scanned from standard XDG application
directories. MIME handlers are ranked by specificity using the number
of declared MimeType entries.

.SH EXAMPLES

.PP
Example configuration:

.PP
.nf
major:text = nvim {target}
ext:pdf = zathura {target}
url:*github.com* = firefox {target}
terminal = alacritty -e
default = code {target}
launcher = rofi -show run
.fi

.SH AUTHOR
Yogesh