Skip to content

Repository files navigation

Image Viewer

Media · Images — view photos and images on your Passport Prime, decoded entirely on-device.

Wallet QR printouts, diagrams, photos moved over USB — Image Viewer opens them right on your Prime. Browse Internal, Airlock, and USB storage, tap an image, and flip through everything in the folder. PNG, JPEG, GIF, and BMP are all decoded on the device — animated GIFs actually play — with no cloud, no companion app, and no write access: it can look at your files but never touch them.

Image view   Flipping through a folder's images   File browser

Features

  • All three storage locations — Internal, Airlock, and USB, with folder navigation; the list shows just folders and images.
  • Four formats — PNG, JPEG, GIF, and BMP, scaled to fit the screen with drag-panning for tall images.
  • Animated GIFs play — decoded frame-by-frame and cycled on-device.
  • Flip through a folder — previous/next moves between the folder's images, not just pages of one file.
  • Strictly read-only — the app's signed permission manifest contains no write grants at all; it cannot modify, create, or delete anything.
  • Graceful with bad files — a corrupt or mislabeled image shows a clear error banner and the app keeps running.
  • Offline by design — Prime has no network stack; your images never leave the device.

Install on your Passport Prime

Grab prime-image-viewer.app from the latest release, copy it to a USB drive or the Airlock, and install it from Settings > Apps > Install App (KeyOS 1.4 or later).

The first ByteApps app you install also needs our publisher certificate trusted once: download byteapps.crt (also attached to every release), copy it over the same way, and add it under Settings > Apps > Allowed Publishers. Before trusting it, check that its fingerprint matches the one published at byteapps.com:

1bca27c8e765a77fd44922bc058b815b46e627d68f2996e8c38ca6997b6be6f9

Get it running

With the Foundation SDK installed, build and launch in the simulator with:

foundation sim

Learn more

Support

If this app is useful to you, a small bitcoin donation is always appreciated — entirely optional.

Donate bitcoin

bc1qkmg7qek6vuuw6hqp9sm06krzcr7pwd5jhcr43f

Donations help cover development costs and keep more open-source bitcoin tools coming. No VC funding, no ads, no tracking.

License & disclaimer

Licensed under the GNU General Public License v3.0 or later — see COPYING.

This software is provided "as is", without warranty of any kind, express or implied. Use it at your own risk — to the maximum extent permitted by law, the authors, copyright holders, and contributors are not liable for any claim, damages, or other liability, including loss of data, arising from this software or its use.

About

Image Viewer for Passport Prime — photos and animated GIFs decoded entirely on-device, strictly read-only

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages