A lightweight TUI (ncurses-like) display manager for Linux and BSD (mirror of https://codeberg.org/fairyglade/ly).
Go to file
Zac cddf792840
Doom fire bug note
It would be handy for other users to know this, instead of having to search through the issues list for a solution.
2019-08-13 23:59:36 +10:00
res initial commit 2019-06-10 16:05:54 +02:00
src remove unused include 2019-06-26 23:11:33 +02:00
sub update submodules 2019-06-26 22:51:42 +02:00
.gitea initial commit 2019-06-10 16:05:54 +02:00
.github initial commit 2019-06-10 16:05:54 +02:00
.gitignore initial commit 2019-06-10 16:05:54 +02:00
license.md initial commit 2019-06-10 16:05:54 +02:00
makefile initial commit 2019-06-10 16:05:54 +02:00
readme.md Doom fire bug note 2019-08-13 23:59:36 +10:00

readme.md

Ly - a TUI display manager

CodeFactor Ly screenshot

Ly is a lightweight TUI (ncurses-like) display manager for Linux and BSD.

Dependencies

  • a C99 compiler (tested with tcc and gcc)
  • a C standard library
  • make
  • pam
  • xcb
  • xorg
  • xorg-xauth
  • mcookie
  • tput
  • shutdown

Support

The following desktop environments were tested with success

  • budgie
  • cinnamon
  • deepin
  • enlightenment
  • gnome
  • i3
  • kde
  • lxde
  • lxqt
  • mate
  • sway
  • xfce
  • pantheon

Ly should work with any X desktop environment, and provides basic wayland support (sway works very well, for example).

systemd?

Unlike what you may have heard, Ly does not require systemd, and was even specifically designed not to depend on logind. You should be able to make it work easily with a better init, changing the source code won't be necessary :)

Cloning and Compiling

Clone the repository

git clone https://github.com/cylgom/ly.git

Fetch submodules

make github

Compile

make

Test in the configured tty (tty2 by default) or a terminal emulator (but desktop environments won't start)

sudo make run

Install Ly and the provided systemd service file

sudo make install

Enable the service

sudo systemctl enable ly.service

If you need to switch between ttys after Ly's start you also have to disable getty on Ly's tty to prevent "login" from spawning on top of it

sudo systemctl disable getty@tty2.service

Configuration

You can find all the configuration in /etc/ly/config.ini. The file is commented, and includes the default values.

Controls

Use the up and down arrow keys to change the current field, and the left and right arrow keys to change the target desktop environment while on the desktop field (above the login field).

Tips

The numlock and capslock state is printed in the top-right corner. Use the F1 and F2 keys to respectively shutdown and reboot. Take a look at your .xsession if X doesn't start, as it can interfere (this file is launched with X to configure the display properly).

PSX DOOM fire animation

To enable the famous PSX DOOM fire described by Fabien Sanglard, just uncomment animate = true in /etc/ly/config.ini. You may also disable the main box borders with hide_borders = true.

NOTE: there is currently a bug preventing this from appearing. Quoting from issue #106:

Yep it's a bug. You need both /usr/share/wayland-sessions and /usr/share/xsessions folders on your system to have animation. usernamewashidden

Additional Information

The name "Ly" is a tribute to the fairy from the game Rayman. Ly was tested by oxodao, who is some seriously awesome dude.