RaspConfigurator

A shell script to quickly set up a fresh Raspberry Pi environment. It automatically installs your favorite editors, programs, and Python libraries — fully customizable to fit your needs.

---

✨ Features

• Installs editors, programs and Python libraries in one shot
• Fully customizable via simple text files
• Supports one-line remote execution
• Sets up NoMachine for remote desktop access
• Configures USB Gadget mode

---

⚙️ Requirements

• Raspberry Pi with a fresh OS install
• Internet connection
• curl and git installed

---

🚀 Usage

Quick start (default setup)

bash -c "$(curl -fsSL https://raw.githubusercontent.com/Buginsideme/RaspConfigurator/refs/heads/main/main)"

Manual setup

1. Clone the repository:

   git clone https://github.com/Buginsideme/RaspConfigurator.git
   cd $HOME/RaspConfigurator

2. Add the programs you want to install to packages.txt
3. Add the Python libraries you need to requirements.txt
4. Run the script:

   chmod +x main
   ./main

---

📋 After Installation

Important

Check the NoMachine version in the bootstrap file before running.

• Switch to x11 before running the script to avoid a black screen in NoMachine:

  sudo raspi-config

  See: NoMachine black screen fix

• Enable USB Gadget mode:

  sudo rpi-usb-gadget on
  sudo reboot now

  See: rpi-usb-gadget guide

---

🔗 References

• Oh-my-bash
• NeoVim
• LazyVim
• NoMachine for Raspberry Pi

---

📌 To-Do

⏳ In Progress

• Test it on the Pi Zero
• Command to run it directly
• Add badges

✅ Completed

• Add NoMachine
• Add usage section
• Add description
• Code refactoring
• Improve description
• Add Python and virtual env support