140 lines
3.1 KiB
Markdown
140 lines
3.1 KiB
Markdown
# SDG-OS
|
|
|
|
mangoWC dotfiles with DMS integration
|
|
|
|
## auto-install
|
|
|
|
clone the repository into your home (~) directory:
|
|
|
|
`cd ~`
|
|
|
|
`git clone https://git.sdgcloud.nl/SDGDen/SDG-OS.git`
|
|
|
|
make the install script executable
|
|
|
|
`cd SDG-OS`
|
|
|
|
`chmod a+x install.sh`
|
|
|
|
run the install script
|
|
|
|
`./install.sh`
|
|
|
|
this will also set up automatic updates. any files you manually alter will stop auto-updating.
|
|
|
|
updates run automatically on startup via git pull, you can update manually by going into the SDG-OS directory and running `git pull`
|
|
|
|
to turn updates off, run the following command:
|
|
|
|
`echo "off" > ~/.coinfig/SDGupdate.state`
|
|
|
|
## manual install
|
|
|
|
clone the repo.
|
|
|
|
`git clone https://git.sdgcloud.nl/SDGDen/SDG-OS.git`
|
|
|
|
copy the files to your .config folder if you want to modify them yourself
|
|
|
|
`cd SDG-OS`
|
|
|
|
`cp -r mango ~/.config`
|
|
|
|
`cp -r sdgos ~/.config`
|
|
|
|
or use stow to symlink them if you want automatic updates
|
|
|
|
`cd SDG-OS`
|
|
|
|
`stow .`
|
|
|
|
or manually symlink them
|
|
|
|
`sudo ln -sf /home/$(whoami)/SDG-OS/mango /home/$(whoami)/.config`
|
|
|
|
`sudo ln -sf /home/$(whoami)/SDG-OS/sdgos /home/$(whoami)/.config`
|
|
|
|
then make the scripts in the sdgos folder executable:
|
|
|
|
`sudo chmod -R a+x ~/.config/sdgos`
|
|
|
|
lastly, pick whether you want to use automatic updates or not (only relevant if you used stow or symlinks)
|
|
|
|
`echo "on" > ~/.config/SDGupdate.state`
|
|
|
|
use "on" for automatic updates on boot or "off" to not have automatic updates
|
|
|
|
|
|
|
|
manual updates can be done by CDing into the SDG-OS directory and running `git pull`
|
|
|
|
|
|
you may need to tweak around with some stuff to get application auto-theming to work, reference the DMS docs:
|
|
https://danklinux.com/docs/dankmaterialshell/application-themes
|
|
|
|
as well as the mangoWM docs:
|
|
https://mangowm.github.io/docs
|
|
|
|
|
|
please be sure to tweak the display config using dms or by editing monitors.conf to match your displays!
|
|
|
|
|
|
for keybinds, press super+k. these are automatically updated from your binds.conf file.
|
|
|
|
|
|
# needed software:
|
|
|
|
(aur)mangowm-git
|
|
ghostty
|
|
firefox
|
|
dms-shell
|
|
nautilus
|
|
brightnessctl
|
|
pipewire-pulse
|
|
pipewire
|
|
(aur)dsearch-bin
|
|
matugen
|
|
adw-gtk-theme
|
|
wl-copy
|
|
hyprshot
|
|
grim
|
|
satty
|
|
fzf
|
|
micro
|
|
|
|
|
|
# installation of that software:
|
|
|
|
`sudo pacman -Syu ghostty firefox dms-shell yay git nautilus brightnessctl pipewire-pulse pipewire matugen adw-gtk-theme wl-copy hyprshot grim satty`
|
|
|
|
`yay -S mangowm-git dsearch-bin`
|
|
|
|
|
|
# mango-config editor script
|
|
|
|
you can open the mango config editor with super+m, this opens a terminal in which you can select a config file and see the contents of that config file.
|
|
|
|
this script has a variable for the editor, it uses micro by default, but you can change the line "app=micro" to any editor you'd like.
|
|
|
|
|
|
# contributing
|
|
|
|
anyone with an SDGCloud account can work on forks of this repository and send code in for review, just shoot me a message if you have something interesting for the config and i'll take a look at it!
|
|
|
|
|
|
# requesting features
|
|
|
|
just message me on discord lmao.
|
|
|
|
|
|
|
|
# Updates:
|
|
|
|
17-05-2026 - added auto-updater as well as install script.
|
|
|
|
17-05-2026 - added screenshot capability through scripts, first run modal (opens settings and keybinds popup on first boot) and added a somewhat-simple mango config editor script.
|
|
|
|
|
|
|
|
|