- Shell 56.1%
- CSS 43.9%
| mod | ||
| skel | ||
| .gitmodules | ||
| .void-pkgs | ||
| .void-pkgs-extended | ||
| build.sh | ||
| configure.sh | ||
| install.sh | ||
| LICENSE | ||
| README.md | ||
ryudov2
plugnplay void plan9port/linux
The goal of this project is to provide a cohesive plan9port/linux implementation on top of voidlinux.
structure
skel/contains default dotfiles and expected directory strucure for a usermod/contains modules: custom program and shellcode for implementing the environmentconfigure.shinstalls dependencies and eventually will configure themes and application defaultsbuild.shbuilds modulesinstall.shinstalls components (skel and modules)
getting started
- install a fresh voidlinux system. only required package is git
$ git clone https://forge.lightcrystal.systems/nilix/ryudov2$ cd ryudov2/$ ./configure.sh && ./build.sh ryudov2 && ./install.sh ryudov2$ cd && startx
using the desktop environment
keybinds
-
super+/: launch a terminal -
alt+space: show application launcher (dmenu) -
alt+tab: cycle windows that aren't hidden -
super+d: destroy window -
super+i: hide window (hidden windows shown in top bar) -
super+u: unhide hidden window at top of stack -
super+m: maximize current window -
super+{h,j,k,l}: quick-tile active window left, down, bottom, top -
super+{q,w,o,p}: quick-tile active window to the corners -
super+{left,right}: switch virtual desktops -
super+shift+{left,right}: move the active window between virtual desktops -
super+s: make the active window sticky -
super+r: resize the current window -
super+v: move the current window -
super+{F1-4}: notify with battery %, notify with time, switch time mode, sync mail -
ctrl+alt+backspace: logout menu
with mouse
right-click on the desktop or empty space in the top bar to get a menu
New: right-click-drag to create a new terminal with the chosen geometryResize: right-click a window, then right-click-drag to change its geometryMove: right-click a window to move it, right-click again to placeDelete: right-click a window to close itHide: right-click a window to hide it (hidden windows shown in top bar)ext.storage: shows removable storage devices and mounts/unmounts them with udiskiewallpaper: change the wallpaper (nitrogen)logout: logout menu
some stuff in the top bar responds to click as well:
- load/mem/swap area: left-click to open the launcher (dmenu), right click to show a terminal with htop
- network and battery area: left-click to open a terminal with nmtui, middle-click for alsamixer, right click to show battery percentage
- clock: left-click to swap modes
- power button: left-click to open the logout menu
other cool mousebinds:
super+left-clickinside a window: move the windowsuper+right-clickinside a window: resize the window
default applications
- terminal: st
- file manager: pcmanfm-qt
- web browser: surf
- email: msmtp, isync, mblaze (configuring these are easy)
- media player: mpv
- image viewer: nsxiv
- text editor: micro
- pdf viewer: mupdf
- archiver: xarchiver
Other applications that are installed to provide a reasonably complete desktop system:
- libreoffice
- vivaldi
- signal
- gimp
- mixxx
- audacious
- audacity
- kdenlive
- and some command line multimedia utils (see
.void-pkgs)
Optionally you can pass -x to configure.sh and it will install a swath of additional tools which power users and IT professionals may find useful, based on Leah Neukirchen's hrmpf package list.
gochas
the arvelie/neralie clock mode in the panel has its epoch set at 2021; if you want to change this, change it in mod/xneralie/neralie.c and then ./build.sh xneralie && ./install.sh xneralie
license
This project is distributed under the MIT license. It uses git submodules which are distributed under other licenses including the GPLv3. As this downloads and runs on an existing system and doesn't compile GPL code into other code, and the code of other projects/modules is clearly separated, I feel MIT license is appropriate for this.