01. Overview & Architecture

Schema validatedSource pinned
Purpose
AwesomeWM rice with Material-style widgets, dashboard and lockscreen in Lua.
Compatibility
Any distro (Server: X11)
Window Manager & Theme
AwesomeWM / Other

02. Installation & Deployment

Before you installThis changes your desktop configuration. Run it as your normal user, never with sudo: it asks for sudo only where a step needs it (listed below).The guided installer shows its plan first. Files it would replace are kept unless you approve. Everything it copies, clones or appends to in your home folder is backed up and verified first, and --rollback restores it. Packages, sudo changes and the other commands listed under Impact are not undone.
IntegrityEach release from main builds the installers in GitHub Actions and signs them with a GitHub build attestation. Verify your download against the repository, not this website (Option B, step 2). If it does not verify, don't run it.
ImpactRuns the commands listed in the steps below.
RecoveryGuided: backups in ~/.local/state/0xtsoa/backups/, undo with bash install.sh --rollback.Manual: the steps below only write in the download folder or run listed commands.
Option A: manual installAdvanced
Read the source at the reviewed commit, back up, then run each step yourself.
$git clone https://github.com/Syndrizzle/hotfiles ~/0xtsoa-review/syndrizzle-hotfiles# 1. clone to a review folder
$git -C ~/0xtsoa-review/syndrizzle-hotfiles checkout --detach 37c38f46ef1518caf7c04b8a3821bf0ef0bda4cf# 2. the reviewed commit
Then the steps. Package commands are written for Arch; on other distros use your package manager.

Step-by-step deployment protocol

Step-by-step deployment
1Clone the repository
$git clone --filter=blob:none https://github.com/Syndrizzle/hotfiles
$git -C hotfiles checkout 37c38f46ef1518caf7c04b8a3821bf0ef0bda4cf
$cd hotfiles
2Follow the upstream README
$xdg-open https://github.com/Syndrizzle/hotfiles#readme
Option B: guided installerRecommended
The same steps as one script for any distro. It shows the plan first, keeps files you already have unless you approve replacing them, and backs up everything it changes in your home folder. Never pipe it into a shell.
$curl -fsSLo install.sh 'https://www.0xtsoa.dev/configs/syndrizzle/hotfiles/install.sh'# 1. download
$gh attestation verify install.sh --repo nyharena25/0xTsoa --signer-workflow nyharena25/0xTsoa/.github/workflows/attest-installers.yml# 2. verify (GitHub CLI 2.49+, signed in)
$less install.sh# 3. read it
$bash install.sh --dry-run# 4. preview: changes nothing
$bash install.sh# 5. install (asks first)
$bash install.sh --rollback# undo the file changes
View script in browserOther options: --force (replace conflicts, backed up first), --yes, --help

03. Screenshot Gallery // Hotfiles

Capture 01 // Fullscreen
Hotfiles screenshot 1
01 / 05

04. Documentation & Guide

Source: Syndrizzle/hotfilesRef: 37c38f46ef
README.md|GitHub Flavored Markdown

         

Thanks for the visit!
Welcome to the Hotfiles ️‍🔥 repository! Carefully designed with usability and functionality in mind, while being light on resources!

1. LIMITED SPOOKY Edition

⚠️ NOTE!!! ⚠️ NOTE!!! ⚠️

These dotfiles are not intended to be used as a daily driving medium, I have only uploaded them here so others can get a reference of it. Please, do not open issues about something not working when using these dots, I am sorry but I will not provide any support regarding these dots.



2. FVWM Edition

3. BSPWM Edition

4. Worm Edition

Support

You can always show your support towards these rices by donating me, as this takes a lot of time and hardwork, thank you for using these dotfiles!

Ko-Fi:
![ko-fi](https://ko-fi.com/img/githubbutton_sm.svg)

Librepay:
Donate using Liberapay

GitHub Flavored Markdown (github-markdown-css)README snapshot at 37c38f46ef