tkinter_player/ARCHITECTURE_INSTALL_GUIDE.md

Multi-Architecture Offline Installation Guide

Overview

The enhanced install_offline.sh script automatically detects your system architecture and uses the appropriate libraries.

Architecture Support

64-bit ARM (aarch64) - Raspberry Pi 4/5 with 64-bit OS

• Folder used: req_libraries/
• Files: 18 wheel files
• Key packages:
  • bcrypt-4.3.0-cp39-abi3-manylinux_2_34_aarch64.whl
  • pillow-11.3.0-cp311-cp311-manylinux_2_27_aarch64.whl
  • psutil-7.0.0-cp36-abi3-manylinux_2_17_aarch64.whl

32-bit ARM (armv7l) - Raspberry Pi with 32-bit OS

• Folder used: req_libraries_32bit/
• Files: 18 wheel files
• Key packages:
  • bcrypt-4.3.0-cp311-cp311-linux_armv7l.whl
  • pillow-11.3.0-cp311-cp311-linux_armv7l.whl
  • psutil-6.0.0-cp311-abi3-linux_armv7l.whl

Usage

Simple Installation (Auto-Detect)

./install_offline.sh

The script will:

1. Detect your architecture automatically
2. Choose the correct library folder
3. Install the appropriate packages
4. Create a virtual environment
5. Verify installation

Manual Architecture Check

uname -m

• aarch64 = 64-bit (uses req_libraries/)
• armv7l = 32-bit (uses req_libraries_32bit/)

Folder Structure

tkinter_player/
├── req_libraries/           # 64-bit ARM wheels
├── req_libraries_32bit/     # 32-bit ARM wheels  
├── install_offline.sh       # Auto-detecting installer
└── requirements.txt         # Package list

Benefits

• ✅ Single installer for both architectures
• ✅ Automatic architecture detection
• ✅ No manual intervention needed
• ✅ Proper error messages for missing libraries
• ✅ Complete offline installation support