README.md

   1 Some ebuilds for Gentoo
   2 =======================
   3
   4 * No QA failures [since 2020](https://bugs.gentoo.org/buglist.cgi?component=Overlays&product=Gentoo%20Linux&query_format=advanced&short_desc=[flussence]&short_desc_type=substring)
   5 * Packages receive timely updates (where Atom/RSS release feeds exist)
   6 * GPG-secured ebuilds and manifests (upstream signature checking will be added if they ever do any)
   7
   8 Any bug reports can be sent via the [Gentoo bug tracker](https://bugs.gentoo.org) - use product
   9 “Gentoo Linux”, component “Overlays” and prefix the subject line with `[flussence]` to save the
  10 triagers some time. They will be seen in any case.
  11
  12 Installing
  13 ----------
  14 1. The “walled garden” method:
  15    ```sh-session
  16    # emerge -n eselect-repository
  17    # eselect repository enable flussence
  18    # emaint sync -r flussence
  19    ```
  20
  21 2. Direct setup:
  22    ```sh-session
  23    # cat > /etc/portage/repos.conf/flussence.conf <<EOF
  24    [flussence]
  25    location = /var/db/repos/flussence
  26    sync-type = git
  27    sync-uri = https://repo.or.cz/flussence-overlay.git
  28    sync-git-verify-commit-signature = true
  29    sync-openpgp-key-path = /usr/share/openpgp-keys/flussence.asc
  30    sync-openpgp-key-refresh = no
  31    EOF
  32    # emaint sync -r flussence
  33    # emerge sec-keys/openpgp-keys-flussence::flussence
  34    ```
  35
  36    The last 3 config lines are optional and grant TOFU-level security, which is better than nothing.
  37    You should be suspicious of any `sec-keys` package or dependency change, and not just mine.
  38
  39    `emerge --sync` will emit the following scary message each time because `emerge` does not
  40    understand that system-wide signing keys can be provisioned by `emerge`. You can ignore it:
  41    ```
  42     * Using keys from /usr/share/openpgp-keys/flussence.asc
  43     * Key refresh is disabled via a repos.conf sync-openpgp-key-refresh
  44     * setting, and this is a security vulnerability because it prevents
  45     * detection of revoked keys!
  46     * Trusted signature found on top commit
  47    ```
  48
  49    **Do not** set `sync-openpgp-key-refresh=yes`. It adds no meaningful security, will slow down the
  50    sync process while it times out, and will also allow me to remotely detect your use of `emerge
  51    --sync` in realtime as a side effect.
  52
  53 Contents
  54 --------
  55 This list is manually maintained. Some things may be missing (accidentally or not).
  56 For a complete list, do `eix [-R] -c --in-overlay flussence`
  57
  58 `dev-perl/Crypt-LE` — [Crypt::LE](https://metacpan.org/pod/Crypt::LE)
  59 : A Perl ACME/Let's Encrypt client with minimal dependencies and no surprise third-party traffic.
  60
  61 `dev-perl/Regexp-Debugger` — [Regexp::Debugger](https://metacpan.org/pod/Regexp::Debugger)
  62 : The `rxrx` utility is an entire interactive TUI for watching a regex go through the motions.
  63   Also works as a perl module so you can drop into an interactive debugger mid-program.
  64
  65 `dev-qt/qtstyleplugins` — [Qt5 Themes](https://code.qt.io/cgit/qt/qtstyleplugins.git/)
  66 : Includes the old Qt4 default “Plastique”, and a mostly-working GTK+2 theme engine.
  67   This hasn't been maintained upstream since 2017, but surprisingly still works.
  68   Unfortunately it lacks the pinnacle of FOSS GUI design, Keramik.
  69
  70 `games-engines/dhewm3` — [Doom 3 sourceport](https://dhewm3.org)
  71 : Adds a bunch of modern QoL features - SDL2 joypad support, widescreen, etc.
  72   Good enough to play through the entire game without hitches.
  73
  74 `gnome-extra/gucharmap` — [GTK+2 version of gucharmap](https://wiki.gnome.org/Apps/Gucharmap)
  75 : The last released GTK+2 version of gucharmap, patched to recognise new Unicode characters.
  76   Strictly better than `gnome-extra/gnome-characters` (no Javascript, supports color emoji),
  77   and compared to `kde-apps/kcharselect` is significantly easier to navigate and less laggy.
  78   Make sure to p.mask `gnome-extra/gucharmap::gentoo` if you install this,
  79   or else the higher version number of that Gtk+3 dummy package will override it.
  80
  81 `media-fonts/tt2020` — [Authentic typewriter font](https://fontlibrary.org/en/font/tt2020-base-style)
  82 : A monospace font that uses OpenType alternate glyph tricks to give letters an analogue feel.
  83   This is a heavy download (same order of magnitude as `media-fonts/noto`),
  84   but you can `USE=minimal` to get just the base font without variants.
  85
  86 `media-fonts/ubuntu-font-family` — [The complete Ubuntu font](https://design.ubuntu.com/font/)
  87 : Installs the most up-to-date version of Ubuntu, Ubuntu Mono, and Ubuntu Italic.
  88   These are modern variable fonts supporting arbitrary widths and weights.
  89
  90 `media-sound/audacious`, `media-libs/audacious-plugins` — [Audacious Media Player](https://audacious-media-player.org/)
  91 : Actively tracks upstream development, supports all features from GTK+2 to Qt6, and does it right.
  92   If you want the best possible Audacious setup on Gentoo, use this.
  93
  94   Also exposes plugins that make use of other packages:
  95
  96   `media-libs/adplug` — [AdLib OPL2/3 software emulator](https://github.com/adplug/adplug)
  97   : Old FM synth emulator for MIDI and MIDI-adjacent formats.
  98     Not necessary if you have other MIDI playback methods enabled, but here as an option.
  99
 100   `media-libs/libopenmpt` — [Tracker module playback library](https://lib.openmpt.org/libopenmpt/)
 101   : Module playback library and standalone player.
 102     Better accuracy and format support than libmodplug.
 103
 104 `media-sound/qpwgraph` — [PipeWire Graph Qt GUI Interface](https://gitlab.freedesktop.org/rncbc/qpwgraph)
 105 : Graphical patchbay for PipeWire, directly descended from QJackCtl.
 106   Allows you to connect inputs and outputs manually and save/restore connection sets.
 107
 108 `net-dns/agnos` — [ACME client in Rust](https://github.com/krtab/agnos)
 109 : A mostly automated tool to get subdomain wildcard certificates (using an internal dns-01 server),
 110   only needing a minor static addition to your server's main DNS zone.
 111
 112 `sys-apps/udev-hid-bpf` — [Method and apparatus for patching input devices](https://libevdev.pages.freedesktop.org/udev-hid-bpf/)
 113 : Enables loading user-specified BPF blobs into the kernel to work around bugs in HID devices.
 114   Very niche purpose, but it's here for those who need it.
 115
 116 `sys-process/runit` — [Runit PID1 and service manager](http://smarden.org/runit/)
 117 : The init system I'm using since 2014.
 118   This package tracks vanilla upstream as of 2.2.0, previously Void Linux.
 119   By default requires OpenRC for bringup and shutdown, but this is easily swappable by the sysadmin.
 120
 121 `x11-libs/gtk+:3` — [debloated Gtk+3](https://forums.gentoo.org/viewtopic-p-8245612.html#8245612)
 122 : Contains a NetBSD patch which makes DBus (and auto-spawning of hidden DBus processes) optional.
 123   This ebuild usually has zero-day updates before ::gentoo gets them.
 124
 125 `x11-misc/gcolor2` — [GTK+2 colour picker](https://gcolor2.sourceforge.net)
 126 : Culled from ::gentoo in 2022 as part of their crusade to rid the world of stable software.
 127   The replacement, GColor3, which they didn't even package as a courtesy, is extremely bad.
 128
 129 `x11-themes/qt6gtk2` — [GTK+2 themes in Qt6](https://github.com/trialuser02/qt6gtk2)
 130 : If you're not satisfied with the selection of Qt6-native and Gtk3 themes, give this a try.
 131   Does not play nice with hi-dpi screens, but should still be usable.
 132
 133 `x11-misc/picom` — [standalone X11 compositor](https://github.com/yshui/picom)
 134 : This is a distant descendant of the original xcompmgr.
 135   Supports xrender and OpenGL 3+ with user-defined shaders.
 136
 137 Copyright
 138 ---------
 139 The permissible format of ebuild headers seems to change constantly and so trying to put a precise
 140 copyright notice in them is more effort than it's worth.
 141
 142 If you're just an end user you don't have to care about this,
 143 but for files wholly my own work, GPL2-or-later is granted:
 144
 145     SPDX-License-Identifier: GPL-2+
 146
 147     Copyright © 2012-<current year> flussence <flussence+KQJqCOBTGC@flussence.eu>
 148
 149     This is free software; you can redistribute it and/or modify it
 150     under the terms of the GNU General Public License as published by
 151     the Free Software Foundation; either version 2 of the License, or
 152     (at your option) any later version.
 153
 154 * * *
 155
 156 Reach heaven through violence 💚🏳️‍⚧️
 157
 158 (This markdown file uses extensions in Forgejo's implementation and may not look correct elsewhere.)