Ming-wm is a keyboard-based, retro-themed window manager for Linux. It is single-threaded, and is neither for Wayland or the X Window System - it writes directly to the framebuffer. Inspirations include i3, Haiku, SerenityOS, and Windows98, and it is a conceptual successor to the previous mingde and ming-os.
Create a password.env file in the same directory as build.rs, otherwise the default password will be "incorrect mule lightbulb niche".
For best performance:
cargo build --release --all-features
The user may need to be added to the video group.
Exclude --all-features if the audio player window is not needed. To compile and use the audio player window, ALSA dev packages need to be installed (alsa-lib-dev on Alpine, libasound2-dev on Debian, alsa-lib-devl on Fedora, already included with alsa-lib on Arch).
After building, to properly install ming-wm, run the following to put the necessary binaries, font data, and bmp files into /usr/local/bin:
chmod +x ./install
sudo ./installAlternatively, to move the binaries to ~/.local/bin (which probably needs to be added to PATH, run the following:
chmod +x local-install
sudo ./local-installRunning with an onscreen keyboard. The framebuffer may not be redrawn to the screen without a (real) key press. The volume down button seems to work.
evtest needs to be installed.
cargo build --release
./target/release/ming touch
Optionally, in landscape mode:
cargo build --release
./target/release/ming touch rotate
After testing, the install scripts in the previous section can be used.
See /docs/philosophy.md for some hopefully interesting ramblings.
Make sure the permissions of password.env are so other users cannot read or write to it. If there is no plan to recompile, just delete it.
Obviously, don't run the executable with sudo or doas, or as the root user!
Licensed under the GPLv3. The font data in the bmps/shippori-mincho folder are covered by the OFL. The font was created by FONTDASU. The font data in bmps/nimbus-roman are licensed under the AGPL. This is a very slightly modified version of the font was created by URW Studio. The font data in bmps/nimbus-romono is also licensed under the AGPL. This is a slightly modified version of the Nimbus Roman font by URW Studio.