Raspberry Pi Manager

A command-line toolkit for managing Raspberry Pi operations. Log, track, and organize entries across multiple operational categories — from device connections and syncing to monitoring, automation, notifications, and reporting. All data is stored locally with timestamped history, full-text search, and multi-format export.

Commands

The following commands are available via raspberry-pi-manager <command> [args]:

Core Operations

Utility Commands

Data Storage

All data is persisted locally in ~/.local/share/raspberry-pi-manager/:

• Per-command logs — Each command (connect, sync, monitor, etc.) writes to its own .log file with YYYY-MM-DD HH:MM|<input> format.
• Global history — Every action is also appended to history.log with MM-DD HH:MM <command>: <input> format for unified audit trail.
• Export files — Generated exports are saved as export.json, export.csv, or export.txt in the same directory.

No external services, databases, or network connections are required. Everything runs locally via bash.

Requirements

• Bash 4+ (uses local variables, set -euo pipefail)
• Standard Unix utilities: date, wc, du, head, tail, grep, basename, cat
• No root privileges needed
• No external dependencies or package installs

When to Use

1. Tracking Pi fleet operations — Log connect/sync/monitor events across multiple Raspberry Pi devices to maintain an operational journal.
2. Building an automation audit trail — Record every automation task and webhook trigger so you can trace what happened and when.
3. Generating operational reports — Use stats, recent, and export to produce summaries for weekly reviews or incident investigations.
4. Organizing scheduled maintenance — Use schedule to document planned tasks (reboots, updates, backups) and notify to log alert dispatches.
5. Searching historical records — Use search to quickly find past events across all categories when troubleshooting an issue.

Examples

# Log a new SSH connection to a Pi
raspberry-pi-manager connect "SSH to pi@192.168.1.50 — firmware update session"

# Record a file sync event
raspberry-pi-manager sync "rsync /home/pi/data → NAS backup completed, 2.3GB transferred"

# Log a temperature monitoring alert
raspberry-pi-manager monitor "CPU temp 72°C on pi-node-3 — fan triggered"

# Record an automation task
raspberry-pi-manager automate "Cron job added: /home/pi/scripts/backup.sh every Sunday 02:00"

# View summary statistics
raspberry-pi-manager stats

# Export all data as JSON
raspberry-pi-manager export json

# Search for all entries mentioning 'backup'
raspberry-pi-manager search backup

# Check overall health status
raspberry-pi-manager status

# View the 20 most recent activities
raspberry-pi-manager recent

How It Works

Each command follows the same pattern:

1. With arguments — Timestamps the input, appends it to the command-specific log file, increments the entry count, and writes to the global history log.
2. Without arguments — Displays the 20 most recent entries from that command's log file.

The stats command aggregates counts across all log files. The export command iterates through all logs and produces a unified output in your chosen format. The search command performs a case-insensitive grep across every log file.

Powered by BytesAgain | bytesagain.com | hello@bytesagain.com