README

rde

Developer and power user friendly GNU/Linux distribution based on GNU Guix package manager.

More info is available at trop.in/rde.

Disclaimer: The rde project is stable and usable, but still under active development and API is a subject to change.

Principles

This is a brief list of principles, more detailed description can be found in the manual.

Main

Ergonomic

Sane keybindings, good contrast, readable fonts.

Reproducible

Setup can be easily replicated.

Hackable

Easy to throw out or modify any part of setup.

Stateless

All state must be explicit and syncable or temporary.

Secondary

Lightweight and battery efficient

wayland, fast native apps.

Offline

most of workflows and apps should work without network.

Attention-friendly

minimal use of notification and other distractive things.

Usage

Read Getting Started section of the manual, skim through the source code and enjoy the thing!

Channel introduction

In case you want to use rde as a channel, there is a channel definition:

(cons*
 (channel
  (name 'rde)
  (url "https://git.sr.ht/~abcdw/rde")
  (introduction
   (make-channel-introduction
    "257cebd587b66e4d865b3537a9a88cccd7107c95"
    (openpgp-fingerprint
     "2841 9AC6 5038 7440 C7E9  2FFA 2208 D209 58C1 DEB0"))))
 %default-channels)

Add it to ~~/.config/guix/channels.scm~, and call guix pull or manage it any other way you want.

Just a screenshot

A picture to catch your eye)

https://cdn.fosstodon.org/media_attachments/files/106/900/674/950/793/851/original/4b17f03528571ca0.png

Tools

Community

There are a few mailing lists you can subscribe and/or post with your existing email account:

~abcdw/[email protected]

for news and updates.

~abcdw/[email protected]

for discussions and questions.

~abcdw/[email protected]

for patches and development related discussions.

Join #rde IRC channel on libera.chat.

Check out Community section of the manual.

Contributing

To propose new features, fixes or ideas send emails, optionally with inline patches to rde-devel mailing list. As usual more info is available in Contributing section of the manual.

People’s rde configurations

Those repositories are not affilated with rde or Guix, they are provided as real-world examples of people’s rde configurations, which you can inspect to get familiar with its concepts, but be careful and thoughtful, remember that blindly copying snippets of code from the internet can have a huge security implications on your setup. If you think other users might learn from your configuration and you’d like to share it publicly, let us know via the <a href=”* Community”>community channels. For Guix Home example configurations, see <a href=”* People’s Guix Home configurations”>People’s Guix Home configurations.

• Andrew Tropin’s configuration part 1, part 2.
• Nicolas Graves’ dotfiles.
• The GNU/Linux+Engstrand system guix-dotfiles.
• Demis Balbach’s dots.
• Miguel Ángel Moreno’s guix-config
• Benoit J’s dotfiles.
• jgart’s confetti.
• Kabelo M’sobomvu Moiloa’s dotfiles.

Guix Home

Guix Home is a part of GNU Guix now, no additional installation steps are required anymore.

People’s Guix Home configurations

Those repositories are not affilated with rde or Guix, they are provided as real-world Guix Home usage examples, but be careful and thoughtful, remember that blindly copying snippets of code from the internet can have a huge security implications on your setup.

• yoctocell’s full-blown configuration with variety of software.
• krevedkokun’s Emacs(Evil)/Wayland(Sway) compact and clean config.
• Nicolas Graves’ dotfiles forked from krevedkokun’s.
• akagi’s configurations, home and system services and packages.