https://github.com/umarquez/rbpi-tools
Tools and scripts for setting up a Raspberry Pi
https://github.com/umarquez/rbpi-tools
Last synced: 10 months ago
JSON representation
Tools and scripts for setting up a Raspberry Pi
- Host: GitHub
- URL: https://github.com/umarquez/rbpi-tools
- Owner: umarquez
- Created: 2025-06-27T02:45:26.000Z (12 months ago)
- Default Branch: main
- Last Pushed: 2025-06-27T05:05:48.000Z (12 months ago)
- Last Synced: 2025-06-27T05:38:28.784Z (12 months ago)
- Language: Shell
- Size: 7.81 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Raspberry Pi Tools (rbpi-tools)
Colección de scripts y *Makefile* para configurar rápidamente una Raspberry Pi (Bookworm, ARM64) como estación de desarrollo multimedia.
## Características
* Instalación automatizada de:
* Dependencias de compilación comunes (build-essential, cmake, git-delta…).
* [Fastfetch](https://github.com/fastfetch-cli/fastfetch) – System info CLI.
* [Go](https://go.dev/) con versión y arquitectura parametrizables.
* [Sonic Pi](https://sonic-pi.net/) 4.5.1.
* [Starship](https://starship.rs/) prompt + integración con `~/.bashrc` o `~/.zshrc`.
* Scripts idempotentes y portables – `set -euo pipefail`, clonado *shallow*, limpieza tras compilación.
* Lint (`make lint`) con **shellcheck** y **shfmt**.
* Tests (`make test`) basados en **Bats**.
* Flujo CI listo para GitHub Actions.
## Requisitos
* Raspberry Pi con Raspberry Pi OS Bookworm 64-bit.
* Usuario con permisos `sudo` sin contraseña.
* Acceso a internet.
## Instalación rápida
```bash
# Clonar el repo
$ git clone https://github.com/tu-usuario/rbpi-tools.git
$ cd rbpi-tools
# Ejecutar instalación completa
$ make setup
```
> **Nota:** `make setup` puede tardar varios minutos — compila *Fastfetch* desde el código fuente.
### Instalar componentes individuales
```bash
# Solo dependencias base
make deps
# Solo Starship
make starship
```
## Uso
Una vez completado `make setup`, abre una nueva terminal o ejecuta:
```bash
source ~/.bashrc # o ~/.zshrc
```
Deberías ver Fastfetch y el prompt de Starship al iniciar sesión.
## Desarrollo
* Lint: `make lint`
* Tests: `make test`
* Limpiar artefactos: `make clean`
Instala *pre-commit* hooks:
```bash
pip install pre-commit
pre-commit install
```
## Contribuir
Se aceptan PRs con nuevas utilidades o mejoras. Por favor, abre un *issue* antes para discutir cambios mayores.
## Licencia
Este proyecto se distribuye bajo la licencia **MIT**. Consulta el archivo `LICENSE` para más información.