Offload App

Offload is a simple tool for offloading files from memory cards and external drives using checksum verification.

Features

• Transfer files from a memory card or removable drive.
• Checksum verification using xxhash.
• File renaming based on date or other relevant variables.
• Keep your files organized in date based folder structures.

Usage

1. Download the latest version of the app from the website.
2. Run the app.
3. Enjoy!

Development

The project supports macOS on Apple Silicon (M1) and Intel. Python 3.12+ is required.

• Setup: Install Python 3.12 (e.g. via Homebrew or pyenv), then:

  pipenv install --dev

• Tests: Run the test suite with pytest:

  pipenv run pytest

• Lint/format: Run ruff:

  pipenv run ruff check offload tests && pipenv run ruff format --check offload tests

• Pre-commit (optional): Install hooks so ruff and format run before each commit:

  pipenv run pre-commit install

• Run the GUI: From the project root:

  pipenv run python -m offload.gui

  or pipenv run python offload/gui.py
• Build the .app bundle (macOS): Uses py2app; produces a native arm64 app on Apple Silicon:

  make zip      # build .app and create dist/Offload.zip
  make all      # build, zip, copy to website assets and /Applications

  Or manually: pipenv run python setup.py py2app. The built app is in dist/Offload.app.

Credits

• Source Sans Pro https://github.com/adobe-fonts/source-sans-pro