jrittenh-overlay

Personal Gentoo overlay (profiles/repo_name: jrittenh). Actively maintained: app-editors/cursor, sys-auth/libfprint, and app-admin/1password-cli (CLI only). Remaining ebuilds are experimental or candidates for removal. A discover-portage-backend ebuild is planned but not in the tree yet.

The 1Password desktop app is best tracked in gentoo-zh (app-admin/1password). That ebuild installs op under /opt/1Password/ but does not put it on your PATH or apply the CLI setgid group—use app-admin/1password-cli from this overlay alongside it.

Install from GitHub

1. Sync the repository

sudo mkdir -p /var/db/repos/jrittenh
sudo git clone https://github.com/jrittenh/jrittenh-overlay.git /var/db/repos/jrittenh

Or use Portage's git sync (recommended so eix-sync / emaint can update it):

sudo install -d /etc/portage/repos.conf
sudo cp repos.conf.example /etc/portage/repos.conf/jrittenh.conf
sudo emaint sync -r jrittenh

2. Use the overlay

With repos.conf in place, Portage discovers jrittenh automatically after sync—no eselect repository step required while the repo is only on GitHub.

sudo emaint sync -r jrittenh
portageq repos_config /var/db/repos/jrittenh | head

Optional one-time registration via eselect (alternative to copying repos.conf.example yourself):

sudo eselect repository add jrittenh git https://github.com/jrittenh/jrittenh-overlay.git
sudo emaint sync -r jrittenh

Once this overlay is listed in the Gentoo Overlays catalog, you can instead use eselect repository enable jrittenh.

After repos.conf exists with auto-sync = yes, eix-sync or emaint sync -a keeps the tree current.

3. Accept keywords / licenses / masks as needed

Default ACCEPT_LICENSE="-* @FREE" blocks proprietary packages. Cursor requires accepting the overlay license:

app-editors/cursor cursor

Add that to /etc/portage/package.license (or allow cursor in ACCEPT_LICENSE globally). The license text is in licenses/cursor in this repo and points to Cursor Terms of Service.

Several packages use ~amd64 or live ebuilds. Adjust /etc/portage/package.accept_keywords, package.unmask, and package.mask for your system. Live libfprint-9999 needs a keyword entry, for example:

sys-auth/libfprint

Updating

Method	When
eix-sync	Repo listed in /etc/portage/repos.conf with auto-sync = yes
emaint sync -r jrittenh	Sync only this overlay
git -C /var/db/repos/jrittenh pull	Manual clone without repos.conf

After syncing, run eix-update if you use eix for indexing.

1Password CLI (op)

Typical setup: desktop from gentoo-zh, CLI from this overlay.

1. Enable and sync gentoo-zh if you use the GUI.
2. Sync jrittenh and merge:

sudo emerge -av acct-group/onepassword-cli app-admin/1password-cli::jrittenh

3. /etc/portage/package.license:

app-admin/1password-cli all-rights-reserved

4. Add yourself to the CLI group and start a new session:

sudo gpasswd -a "${USER}" onepassword-cli

5. Sign in (first time: op account add per upstream docs):

eval "$(op signin)"
op whoami

Quick check without Portage: if you only installed gentoo-zh’s desktop, try /opt/1Password/op whoami. If that works but op does not, you were missing a /usr/bin/op symlink and setgid—install app-admin/1password-cli above instead of hand-copying the binary.

Packages

Category	Package	Status
app-editors	cursor	Maintained; golden-channel .deb repack
app-admin	1password-cli	Maintained; op CLI (pairs with gentoo-zh desktop)
sys-auth	libfprint	Maintained; live ebuild tracking upstream fork
dev-libs	sfl	Dependency for openloco; verify before use
games-simulation	openloco	Experimental
media-video	jellyfin-desktop	Parked; old Qt ebuild — plan rewrite for CEF-based client
(planned)	discover-portage-backend	Not yet added

Install elsewhere (removed from this overlay)

Software	Suggested source
1Password desktop only	gentoo-zh app-admin/1password
Gittyup	Flathub com.github.Murmele.Gittyup (Portage build was dependency-heavy and unmaintained here)
draw.io desktop	app-office/drawio-desktop-bin in ::gentoo

Requirements

• Portage with EAPI 9 support (Council-approved 2025-12; included in current stable Portage).
• Synced gentoo tree as master (metadata/layout.conf).

Layout

Standard Portage overlay layout (EAPI 9, thin manifests):

• metadata/layout.conf — masters gentoo, manifest-hashes, sync protocols
• metadata/project.xml — overlay maintainer
• profiles/repo_name, profiles/eapi, profiles/description
• Per-package metadata.xml under each package directory
• Category trees under app-*, dev-*, games-*, media-*, sys-*

Regenerate manifests after changing distfiles:

ebuild path/to/foo/foo-1.0.ebuild manifest
# or: repoman manifest path/to/foo

Contributing / upstream overlay

This overlay is personal today. Before requesting inclusion in the Gentoo Overlays project (eselect repository list), expect CI (pkgcheck / pkgdev scan), repoman-clean ebuilds, and stabilization of stale packages.

Local QA:

pkgcheck scan --repo /var/db/repos/jrittenh

Bug reports and fixes are welcome via GitHub issues and pull requests.

License

Ebuilds are licensed per their LICENSE= fields. Overlay metadata and documentation are offered as-is for personal use.