README.md

   1 Some ebuilds for Gentoo
   2 =======================
   3
   4 These are my packages for things that:
   5
   6 * aren't in the main Gentoo tree at all,
   7 * aren't as up-to-date as I'd like there,
   8 * aren't maintained to a sufficient standard in the main tree.
   9
  10 Bug reports can be sent via the [Gentoo bug tracker](https://bugs.gentoo.org): to ensure it gets
  11 seen in a timely manner, use product “Gentoo Linux”, component “Overlays” and prefix the subject
  12 line with `[flussence-overlay]`.
  13
  14 Packages that install arch-independent stuff will be keyworded for non-exotic arches only:
  15 x86, arm and their 64-bit versions.
  16
  17 Installing
  18 ----------
  19 1. Direct setup:
  20     ```
  21     root # cat > /etc/portage/repos.conf/flussence.conf <<EOF
  22     [flussence]
  23     location = /var/db/repos/flussence
  24     sync-type = git
  25     sync-uri = https://repo.or.cz/flussence-overlay.git
  26     EOF
  27     root # emaint sync -r flussence
  28     ```
  29     1) Optional but strongly recommended - GPG verification:
  30         ```
  31         root # emerge sec-keys/openpgp-keys-flussence::flussence
  32         root # cat >> /etc/portage/repos.conf/flussence.conf <<EOF
  33         sync-git-verify-commit-signature = true
  34         sync-openpgp-key-path = /usr/share/openpgp-keys/flussence.asc
  35         sync-openpgp-key-refresh = no
  36         EOF
  37         ```
  38        Note that Portage was never designed with a secure supply chain in mind,
  39        and `emerge --sync` will emit the following scary message (which you should ignore):
  40         > ```
  41         >  * Using keys from /usr/share/openpgp-keys/flussence.asc
  42         >  * Key refresh is disabled via a repos.conf sync-openpgp-key-refresh
  43         >  * setting, and this is a security vulnerability because it prevents
  44         >  * detection of revoked keys!
  45         >  * Trusted signature found on top commit
  46         > ```
  47 3. The “walled garden” method:
  48     ```
  49     root # emerge -n eselect-repository
  50     root # eselect repository enable flussence
  51     root # emaint sync -r flussence
  52     ```
  53
  54 Contents
  55 --------
  56 This list is manually maintained. Some things may be missing (accidentally or not).
  57 For a complete list, do `eix [-R] -c --in-overlay flussence`
  58
  59 `dev-perl/Crypt-LE` — [Crypt::LE](https://metacpan.org/pod/Crypt::LE)
  60 : A Perl ACME/Let's Encrypt client with minimal dependencies and no surprise third-party traffic.
  61
  62 `dev-perl/Regexp-Debugger` — [Regexp::Debugger](https://metacpan.org/pod/Regexp::Debugger)
  63 : The `rxrx` utility, a lifesaver when trying to figure out what a Perl regex is doing.
  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 lacks the pinnacle of FOSS GUI design, Keramik.
  69
  70 `gnome-extra/gucharmap` — [GTK+2 version of gucharmap](https://wiki.gnome.org/Apps/Gucharmap)
  71 : The last released GTK+2 version of gucharmap, patched to recognise new Unicode characters.
  72   Strictly better than the current GNOME 3 replacement (no Javascript, supports color emoji),
  73   and is significantly easier to navigate and less laggy than `kde-apps/kcharselect`.
  74   Make sure to p.mask `gnome-extra/gucharmap::gentoo` if you install this,
  75   or else the higher version number of the GTK+3 one will override it.
  76
  77 `media-fonts/tt2020` — [Authentic typewriter font](https://fontlibrary.org/en/font/tt2020-base-style)
  78 : A monospace font that uses OpenType alternate glyph tricks to give letters an analogue feel.
  79   This is a heavy download (same order of magnitude as `media-fonts/noto`),
  80   but you can `USE=minimal` to get just the base font without variants.
  81
  82 `media-libs/libopenmpt` — [OpenMPT playback library](https://lib.openmpt.org)
  83 : A modern replacement for modplug and mikmod.
  84   Much wider format support, more accurate playback, and better security upkeep.
  85   Supported by `media-sound/audacious` since late 2019.
  86
  87 `media-sound/audacious` — [Audacious Media Player](https://audacious-media-player.org/)
  88 : This ebuild actively tracks upstream development. Gentoo's ebuild has half-decade open bugs.
  89   If you want the best possible Audacious setup on Gentoo, possibly any distro, use this.
  90
  91 `media-sound/qpwgraph` — [PipeWire Graph Qt GUI Interface](https://gitlab.freedesktop.org/rncbc/qpwgraph)
  92 : The nice graph GUI from QjackCtl and ability to save/load patchbays.
  93   Perfect if you aren't interested in any of the other JACK functionality.
  94
  95 `media-plugins/lvis` — [Audacious visualiser plugin](https://git.sr.ht/~kaniini/lvis)
  96 : An Audacious visualiser plugin. Like Winamp AVS, but better.
  97
  98 `net-dns/agnos` — [ACME client in Rust](https://github.com/krtab/agnos)
  99 : A mostly automated tool to get subdomain wildcard certificates (using an internal dns-01 server),
 100   only needing a minor static addition to your server's main DNS zone.
 101
 102 `sys-process/runit` — [Runit PID1 and service manager](http://smarden.org/runit/)
 103 : The init system I'm using.
 104   This package is a hard fork of whatever was in the Gentoo tree circa 2014,
 105   which was full of unfixed bugs and didn't have a responsible maintainer.
 106   Most of it has been rewritten since then and it behaves closer to vanilla.
 107   Currently requires OpenRC for bringup and shutdown; long-term goal is to fix this.
 108
 109 `x11-libs/gtk+:3` — [debloated Gtk+3](https://forums.gentoo.org/viewtopic-p-8245612.html#8245612)
 110 : Contains a NetBSD patch which makes DBus (and auto-spawning of hidden DBus processes) optional.
 111   Usually has zero-day updates before ::gentoo gets them.
 112
 113 `x11-misc/gcolor2` — [GTK+2 colour picker](https://gcolor2.sourceforge.net)
 114 : Culled from ::gentoo in 2022 as part of their crusade to rid the world of stable software.
 115   The replacement, GColor3, which they didn't even package as a courtesy, is extremely bad.
 116
 117 `x11-misc/picom` — [standalone X11 compositor](https://github.com/yshui/picom)
 118 : This is a distant descendant of the original xcompmgr.
 119   Supports xrender and OpenGL 3+ with user-defined shader capabilities.
 120
 121 Copyright
 122 ---------
 123 Due to distro technical debt and office politics, ebuild headers have to carry a GPL2-only statement
 124 without full attribution. I disagree with this, but don't have the resources to fix it.
 125
 126 For files wholly my own work (figuring this out is on you), GPL2-or-later is granted:
 127
 128     SPDX-License-Identifier: GPL-2+
 129
 130     Copyright © 2012-2022 flussence <flussence+KQJqCOBTGC@flussence.eu>
 131
 132     This is free software; you can redistribute it and/or modify it
 133     under the terms of the GNU General Public License as published by
 134     the Free Software Foundation; either version 2 of the License, or
 135     (at your option) any later version.