Jumperless AppImages

Quick Start

Option 1: Use the Wrapper Script (Recommended)

Double-click run_jumperless_appimage.sh
The script will automatically detect your architecture and open Jumperless in a new terminal

Option 2: Use the Desktop File

Double-click Jumperless.desktop
This provides a more polished experience with an icon

Option 3: Run Directly in Terminal

Open a terminal in this folder
Run: ./Jumperless-aarch64.AppImage (for ARM64) or ./Jumperless-x86_64.AppImage (for x86_64)

Files Included

Jumperless-aarch64.AppImage - AppImage for ARM64 systems (Raspberry Pi 4+, ARM servers, Apple Silicon with Linux)
Jumperless-x86_64.AppImage - AppImage for x86_64 systems (Most Linux PCs and laptops)
run_jumperless_appimage.sh - Smart launcher script that detects your architecture
Jumperless.desktop - Desktop entry for GUI file managers
icon.png - Application icon
README_AppImages.md - This file

Features

Smart Launcher Script

✅ Automatically detects your system architecture (ARM64 vs x86_64)
✅ Chooses the correct AppImage for your system
✅ Opens Jumperless in a new terminal window with proper sizing
✅ Works with various terminal emulators (gnome-terminal, konsole, xterm, etc.)
✅ Provides clear error messages and status updates
✅ Shows terminal environment information for debugging

AppImage Benefits

✅ No installation required - just download and run
✅ Self-contained - includes all dependencies
✅ Portable - works on any Linux distribution
✅ Safe - runs in a sandboxed environment

System Requirements

Linux (any distribution)
Architecture: ARM64 (aarch64) or x86_64
Terminal emulator (for best experience)

Troubleshooting

AppImage won't run when double-clicked

Use the wrapper script run_jumperless_appimage.sh instead
Or run directly in a terminal: ./Jumperless-[arch].AppImage

Permission denied error

chmod +x Jumperless-*.AppImage
chmod +x run_jumperless_appimage.sh

Wrong architecture

The launcher script automatically detects your architecture, but if you need to check manually:

uname -m
# aarch64 or arm64 = use Jumperless-aarch64.AppImage
# x86_64 = use Jumperless-x86_64.AppImage

No terminal emulator found

The script will fall back to running in the current terminal if no GUI terminal emulator is found.

About Jumperless

Jumperless is an electronics prototyping tool that bridges Wokwi simulations with physical hardware, allowing you to test your Arduino code on real components without manually wiring breadboards.

GitHub: https://github.com/Architeuthis-Flux/JumperlessV5
Documentation: Check the main repository for detailed documentation
Support: Open issues on the GitHub repository

Technical Details

AppImage Format: Portable Linux application format
Base: Built with PyInstaller from Python source
Size: ~9.2 MB per AppImage
Runtime: Includes Python runtime and all dependencies

3.0 KiB Raw Permalink Blame History