{"id":30815111,"url":"https://github.com/piercingxx/debian-mod","last_synced_at":"2026-05-03T20:37:34.756Z","repository":{"id":309463014,"uuid":"1036319998","full_name":"Piercingxx/debian-mod","owner":"Piercingxx","description":"Automates the installation of a fully‑featured Debian workstation, including optional GPU drivers, Mircosoft Surface support, Hyprland, and a curated set of workstation tools.","archived":false,"fork":false,"pushed_at":"2025-09-03T01:38:32.000Z","size":66,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-09-03T02:32:12.457Z","etag":null,"topics":["debian","gnome","hyprland","linux","microsoft-surface"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Piercingxx.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-08-11T22:42:57.000Z","updated_at":"2025-09-03T01:38:35.000Z","dependencies_parsed_at":"2025-08-12T03:33:14.919Z","dependency_job_id":"3194759c-ab54-4136-9fa0-51f4c686a636","html_url":"https://github.com/Piercingxx/debian-mod","commit_stats":null,"previous_names":["piercingxx/debian-mod"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/Piercingxx/debian-mod","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Piercingxx%2Fdebian-mod","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Piercingxx%2Fdebian-mod/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Piercingxx%2Fdebian-mod/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Piercingxx%2Fdebian-mod/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Piercingxx","download_url":"https://codeload.github.com/Piercingxx/debian-mod/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Piercingxx%2Fdebian-mod/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":273874160,"owners_count":25183368,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-09-06T02:00:13.247Z","response_time":2576,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["debian","gnome","hyprland","linux","microsoft-surface"],"created_at":"2025-09-06T08:04:49.271Z","updated_at":"2026-05-03T20:37:34.689Z","avatar_url":"https://github.com/Piercingxx.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Debian‑mod.sh\n\nAutomates the installation of a fully‑featured Debian workstation, including optional GPU drivers, Mircosoft Surface support, Hyprland, and a curated set of workstation tools.\n\n---\n\n## 📦 Overview\n\n`debian-mod.sh` is a one‑step installer that automates the setup of a fully‑featured Debian workstation.  \nIt installs:\n\n- Core system packages (GNOME, developer tools, etc.)\n- Optional GPU drivers (NVIDIA)\n- Microsoft Surface kernel modules\n- Hyprland\n- Dotfiles from the [Piercing‑Dots](https://github.com/PiercingXX/Piercing-Dots) repo, including:\n  \n\t  - A curated collection of dotfiles \n\t  - One‑step distro-agnostic maintenance script for Linux.\n\t  - A fully‑featured Hyprland setup with waybar\n  \t  - Fully customized distro-agnostic .bashrc with all the best features\n\t  - Minimal Neovim with Yazi file manager\n\t  - GIMP custom layout with default keybinds\n\t  - Ulauncher bound to the SUPER key***\n\t  - Aura color theme\n\n\u003e The script is designed for **x86_64** machines. A mobile version is coming soon.\n\n\n\n---\n\n## ✅ Prerequisites\n\n| Item | Why it matters | How to check |\n|------|----------------|--------------|\n| Fresh Debian 13 Trixie | The script assumes a clean install | `lsb_release -a` |\n| GNOME desktop | Some scripts rely on GNOME utilities | `gnome-shell --version` |\n| Internet connection | Packages are fetched from the network | `ping -c 1 debian.org` |\n\n---\n\n## 🚀 Installation\n\n```bash\n# 1️⃣  Install Git\nsudo apt update \u0026\u0026 sudo apt install git -y\n\n# 2️⃣  Clone this repository\ngit clone https://github.com/PiercingXX/debian-mod\n\n# 3️⃣  Make the scripts executable\nchmod -R u+x debian-mod/\n\n# 4️⃣  Enter the directory\ncd debian-mod\n\n# 5️⃣  Run the main installer\n./install.sh\n```\n\n---\n\n## 🔧 Usage\n\n```bash\n./install.sh\n```\n\n| Option      | Description                                         |\n| ----------- | --------------------------------------------------- |\n| `--dry-run` | Show what would be installed without making changes |\n| `--help`    | Display the help message                            |\n\n---\n\n## 📦 Optional Scripts\n\n| Script | Purpose | When to Run |\n|--------|---------|-------------|\n| `nvidia.sh` | Installs proprietary NVIDIA drivers | **Do not** run on Microsoft Surface devices |\n| `Surface.sh` | Installs Microsoft Surface kernel modules | Only for Surface hardware |\n| `hyprland-setup.sh` | Installs Hyprland and related packages | Use when you want a Wayland session |\n| `testing.sh` | Switches the system to Debian Testing | Only if you’re comfortable troubleshooting |\n\n---\n\n## 🔌 Hardware‑Specific Notes\n\n- **Steam**: Install Steam *before* running `nvidia.sh`. Steam must be fully installed and updated first.\n- **Surface Devices**: Skip `nvidia.sh` to avoid breaking your system on the next update.\n- **Multiple Hard Drives**: Edit `/etc/fstab` to auto‑mount additional drives at boot.\n\n---\n\n## 🎉 Post‑Installation\n\n- **Hyprland**: Log out of GNOME, pick Hyprland at login, and enjoy a Wayland session that actually works.\n- Make sure all your extensions are installed.\n\n---\n\n## 🙏 Credits\n\n- **Linux‑Surface** – Surface kernel bits from the [linux‑surface](https://github.com/linux-surface/linux-surface/wiki) project, integrated into this script.\n- **Piercing‑Dots** – Dotfiles and configurations that makes the workstation usable.\n\n---\n\n## 🤝 Contributing\n\nIf you have suggestions, fork, hack, PR. I'd love to check it out.\n\nPlease keep the [maintenance.sh](vscode-file://vscode-app/opt/visual-studio-code/resources/app/out/vs/code/electron-browser/workbench/workbench.html) script **POSIX‑friendly** and avoid hard‑coding paths.\n\n---\n\n## 📄 License\n\nMIT © PiercingXX  \nSee the LICENSE file for details.\n\n---\n\n## 📞 Support \u0026 Contact\n  \n*Don't*\n\n---\n\n\n*** In Gnome you'll need to manually bind it using the Super Key extension\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpiercingxx%2Fdebian-mod","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpiercingxx%2Fdebian-mod","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpiercingxx%2Fdebian-mod/lists"}