Linux‑Phone‑Mod

Debian‑based phone setup in one go.
Installs essentials, applies Piercing‑Dots GNOME tweaks, and readies your device for the attempt at daily use.

📦 Features

Works on Debian‑based GNOME mobile OS: Droidian (Phosh), Mobian (Phosh), Ubuntu Touch, PureOS
Installs core apps and tooling: Neovim Nightly, Yazi (+ plugins), GNOME Tweaks, Mission Center
Adds Flathub (FLOSS subset) and Homebrew, sets up fonts and shell environment
Waydroid installation (apt or repo fallback), Proton VPN desktop, Tailscale (manual service install)
Enables UFW with SSH rules and performs system cleanups/updates
Applies Piercing‑Dots GNOME customizations and replaces .bashrc with the standard PiercingXX config
- All the keybind .scripts used in desktop/laptop configs are fully functional here as well.

🚀 Quick Start

sudo apt update && sudo apt install git -y
git clone https://github.com/PiercingXX/linux-phone-mod
cd linux-phone-mod
chmod -R u+x scripts/
./linux-phone-mod.sh

Note: The full install can take a while (often hours) on mobile hardware.

🛠️ Usage

Run ./linux-phone-mod.sh and follow the menu prompts.

Menu options:

Install – Runs prerequisites, applies Piercing‑Dots (including GNOME customizations), installs apps, updates shell
Reboot System – Reboots when you’re ready
Exit – Quit without changes

The script will clone and use the Piercing‑Dots repo during setup, then clean up.

📱 Tested On

Google Pixel 3a
- Droidian (Phosh)
- Ubuntu Touch
Librem 5
- PureOS
- Mobian (Phosh)

Did some testing with PostMarketOS Gnome-Mobile on the Librem 5. It wasn't stable enough for a daily driver attempt. Will take another look in the future.

Active daily‑driver testing. Expect changes; mobile Linux platforms evolve quickly or stagnate and die.

⚙️ What Gets Installed (Highlights)

Homebrew + Flathub (FLOSS subset) remotes
Neovim Nightly, Lua 5.4, Python pip, ripgrep, chafa
Yazi file manager with curated plugins and helpers
Waydroid (via apt or repo.waydro.id)
UFW configured (SSH allowed); Proton VPN desktop client
Tailscale (manual install, systemd service enabled)
Proton Beta
Piercing‑Dots GNOME customizations and standard .bashrc

📄 License

🤝 Contributing

Fork, branch, and PR welcome.
Keep scripts POSIX‑friendly and avoid hard‑coded paths.

📞 Support

No direct support provided. Please open an issue if something breaks.

PiercingXX/linux-phone-mod