No description
Find a file
Gijs Burghoorn 02876807fc
Merge pull request #24 from coastalwhite/wm-selector
Update Window Manager selector
2022-01-02 15:09:31 +01:00
.github/workflows Add Rust CI 2022-01-02 14:48:48 +01:00
extra Move additional files to /extra dir 2021-12-31 16:04:00 +01:00
src Merge pull request #24 from coastalwhite/wm-selector 2022-01-02 15:09:31 +01:00
.gitignore Initial commit 2021-12-28 19:43:20 +01:00
Cargo.lock Fix cargo fmt 2022-01-02 15:00:02 +01:00
Cargo.toml Remove logind_dbus dependency 2022-01-02 14:55:12 +01:00
cover.png Add cover image to README 2021-12-31 20:13:45 +01:00
install.sh Add install script 2021-12-31 20:13:45 +01:00
LICENSE-APACHE Create LICENSE-APACHE 2021-12-31 16:07:03 +01:00
LICENSE-MIT Rename LICENSE-MIT.md to LICENSE-MIT 2021-12-31 16:07:16 +01:00
README.md Add Usage chapter 2021-12-31 20:13:45 +01:00

Lemurs 🐒

A TUI Display/Login Manager written in Rust

Cover image

WIP: Whilst the project is working and installable, there are still a lot of bugs and limitations.

A minimal lightweight TUI Display Manager/Login Manager written in Rust similar to Ly.

Goal

The goal of this project is to create a small, robust and yet customizable Login Manager which can serve as the front-end to your graphical GNU/Linux or BSD environment. Lemurs uses Linux PAM as its method of authentication.

Installation

The install.sh script can be used to compile and setup the display manager on your Unix machine. This will perform multiple steps:

  1. Build the project in release mode (requires Rust's cargo)
  2. Setup the /etc/lemurs folder which contains some of the configuration and necessary files such as your selection of window managers.
  3. Disables the previous Display Manager
  4. Copy over the systemd service and enables it.

Although you might first want to set up some window managers (see Usage), upon rebooting you should now see Lemurs.

Usage

After running the installation script you can add your window managers by creating runnable scripts also known as xinitrcs under the /etc/lemurs/wms folders. The name of the script is used as the name within lemurs. For example, for the bspwm window manager, you might add the script /etc/lemurs/wms/bspwm.

#! /bin/sh

sxhkd &
exec bspwm

Remember to make this script runnable. This is done with the chmod +x /etc/lemurs/wms/bspwm command.

Upon rebooting your new xinitrc should show up within Lemurs.

License

The project is made available under the MIT and APACHE license. See the LICENSE-MIT and LICENSE-APACHE files, respectively, for more information.