mirror of https://github.com/fairyglade/ly.git
81 lines
2.4 KiB
Markdown
81 lines
2.4 KiB
Markdown
### Ly - a TUI display manager
|
|
[](https://www.codefactor.io/repository/github/cylgom/ly/overview/master)
|
|
|
|
|
|
Ly is a lightweight, TUI (ncurses-like) display manager for linux.
|
|
|
|
### Dependencies
|
|
Make sure all the following packages are properly installed and configured
|
|
on your linux distribution before going further:
|
|
- a c99 compiler (tested with gcc and tcc)
|
|
- a c standard library
|
|
- make
|
|
- linux-pam
|
|
- xorg
|
|
- xorg-xinit
|
|
- xorg-xauth
|
|
- mcookie
|
|
- tput
|
|
- shutdown
|
|
|
|
### Cloning and Compiling
|
|
This repository uses submodules, so you must clone it like so
|
|
```
|
|
git clone --recurse-submodules https://github.com/cylgom/ly.git
|
|
```
|
|
|
|
To compile you just need to launch make in the created folder
|
|
```
|
|
make
|
|
```
|
|
|
|
Check if it works on the tty you configured (default is tty2). You can
|
|
also run it in terminal emulators, but desktop environments won't start
|
|
```
|
|
sudo make run
|
|
```
|
|
|
|
Then, install Ly and the systemd service file
|
|
```
|
|
sudo make install
|
|
```
|
|
|
|
Now enable the systemd service to make it spawn on startup
|
|
```
|
|
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
|
|
```
|
|
|
|
If messages from other services pop over the login prompt,
|
|
edit open the configuration and make sure `force_update` is enabled
|
|
```
|
|
[box_main]
|
|
force_update=1
|
|
```
|
|
|
|
### Configuration
|
|
All the configuration takes place in `/etc/ly/config.ini`.
|
|
The file is commented, and includes useful defaults.
|
|
|
|
### 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 filed is launched with X to configure the display properly).
|
|
|
|
### 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.
|
|
I wish to thank linux-pam, X11 and systemd developers for not
|
|
providing anything close to a reference or documentation.
|