A streamlined installation script for HamClock on Raspberry Pi OS
This script simplifies the process of installing HamClock, a feature-rich amateur radio clock application, on Raspberry Pi systems. The installer automates dependency installation, source code compilation, and configuration with a focus on hardware display support.
- 🔧 One-Command Installation: Full installation process from dependencies to final configuration
- 📊 Smart Display Sizing: Automatically detects your screen resolution and offers appropriate size options
- 🖥️ Hardware Display Support: Optimized for direct use with Raspberry Pi displays
- ⚙️ Customizable Options:
- Desktop icon creation
- Man page installation
- Autostart on boot configuration
- Raspberry Pi running Raspberry Pi OS Bullseye or Bookworm
- Internet connection
- Display with minimum resolution of 800x480
# Download the installer script
wget https://raw.githubusercontent.com/9M2PJU/Easy-HamClock-Raspberry-Pi-Install/main/rpi-hc-install.sh
# Make the script executable
chmod +x rpi-hc-install.sh
# Run the installer
./rpi-hc-install.shAfter installation, launch HamClock from the terminal by typing:
hamclock &The & symbol runs HamClock in the background, allowing you to continue using the terminal.
If you enabled the autostart option during installation (recommended), HamClock will automatically launch after every system reboot without any manual intervention.
This installer has been streamlined from the original version:
- ✅ Hardware Display Focus: Removed web-only access option
- ✅ Simplified Documentation: Removed user guide installation option
- ✅ Optimized Process: Streamlined installation flow
- ✅ Automatic Startup: Configured for automatic launch on system boot
The installer creates a detailed log file (rpi-hc-install.sh.log) in the same directory as the script. If you encounter issues, check this log for error messages and diagnostic information.
Common issues:
- Build Errors: Ensure all dependencies were installed correctly
- Display Issues: Verify your display meets the minimum resolution requirements
- Permission Errors: Make sure you're not running the script with sudo
| Size Option | Resolution | Recommended For |
|---|---|---|
| Small | 800x480 | 7" displays |
| Medium | 1600x960 | 10-12" displays |
| Large | 2400x1440 | 15-17" displays |
| Extra Large | 3200x1920 | 19"+ displays |
This installer script is provided under the same license as the original HamClock software.
- Original HamClock software by Elwood Downey
- Built for the amateur radio community 📻
