projectmoon-overlay/README.md

2.9 KiB

Personal Gentoo overlay, focusing mostly on needed tools and compatibility for a libre version of Gentoo on the Librem 14 computer. A handful of other pacakages are also provided.

Linux-libre and Librem-related packages:

  • sys-kernel/libre-kernel: A dist-kernel built from the Linux-libre sources.
  • media-fonts/fonts-meta: Modified version to remove non-Free fonts from the dependencies.
  • sys-kernel/librem-ec-acpi: An ebuild packaging the Librem 14 EC ACPI kernel module, necessary for proper functioning of the laptop's battery charging and function keys.
  • sys-power/librem-control: A GTK application to control parameters of the Librem EC (battery charge levels, etc).
  • sys-apps/purism_ectool: Tool for querying and flashing Purism EC firmware images on certain Librem laptops.v

Other Packages:

  • dev-python/ecp: Python implementation of Emacs RPC stack. Depends on orjson or orjson-bin from the GURU (or another) overlay.
  • www-plugins/firefox-pwa-connector: The native host connector for the PWAs for Firefox project.

How to Add This Repository

Using eselect-repository:

# eselect repository add projectmoon git https://git.agnos.is/projectmoon/projectmoon-overlay

It usually a best practice to mask packages from overlays, except the ones you want:

In /etc/portage/package.mask:

*/*::projectmoon

Individual packages can be unmasked (and added to package.accept_keywords if necessary). For instructions on unmasking individual packages, see the relevant documentation below.

The Linux-libre dist-kernel

*See docs/Libre-Kernel.md.

This overlay provides a dist-kernel (based on sys-kernel/vanilla-kernel) using the Linux-libre kernel sources, and an accompanying updated version of virtual/dist-kernel. It is maintained and tested for my personal use on amd64. The Linux-libre kernel removes the ability for the Linux kernel to load firmware that is not Free Software. The ebuild roughly follows the current stable gentoo-kernel for amd64.

Purism Librem Computer Packages

See docs/Librem.md.

This overlay contains packages for Purism's Librem computers, focusing mostly on the Librem 14.

Other Packages

More documentation coming soon.

Packages must be unmasked and added to package.accept_keywords as necessary.

Disclaimer

The ebuilds in this overlay are really only tested for my specific use-case. I do not test every combination of USE flags, for example. So there may be issues with non-Free dependencies etc in some cases.