Pass Viewer

Your rating: None Average: 5 (16 votes)

This is a simple viewer for PassBook® files.

The app searches the file system, starting in the home directory, for passes, and shows them in a list. A tap on the pass shows the details including the barcode (usually the most important thing). The design is simplified compared to the original app, but should be readable.

Passes close to the relevant time are highlighted. It's also possible to highlight passes close to relevant coordinates (check settings). The top highlighted pass is shown on the cover, with the cover action opening the pass directly. Also, highlighted passes are shown in the event view, while the app is running. Calendar entries can be made from passes with a relevant time.

Passes containing an update link may be updated. Changed fields will be marked the first time the pass is viewed after the update.

License: MIT/BSD

Application versions: 
File harbour-passviewer-0.1-1.armv7hl.rpm101.06 KB25/04/2015 - 20:13
File harbour-passviewer-0.2-1.armv7hl.rpm109.88 KB10/05/2015 - 19:05
File harbour-passviewer-0.3-1.armv7hl.rpm132.16 KB22/05/2015 - 21:51
File harbour-passviewer-0.3-2.armv7hl.rpm133.2 KB08/06/2015 - 22:13
File harbour-passviewer-0.4-1.armv7hl.rpm130.57 KB20/06/2015 - 20:15
File harbour-passviewer-0.4-2.armv7hl.rpm131.66 KB25/06/2015 - 23:55
File harbour-passviewer-0.5-1.armv7hl.rpm132.22 KB29/06/2015 - 22:16
File harbour-passviewer-0.6-1.armv7hl.rpm138.48 KB19/07/2015 - 21:37
File harbour-passviewer-0.7-1.armv7hl.rpm147.6 KB02/08/2015 - 15:54
File harbour-passviewer-0.8-1.i486.rpm156.29 KB16/10/2015 - 20:33
File harbour-passviewer-0.8-1.armv7hl.rpm150.11 KB16/10/2015 - 20:33
File harbour-passviewer-0.9-1.i486.rpm201.29 KB21/12/2015 - 21:35
File harbour-passviewer-0.9-1.armv7hl.rpm192.84 KB21/12/2015 - 21:35
File harbour-passviewer-0.10-1.i486.rpm222.37 KB19/01/2016 - 00:18
File harbour-passviewer-0.10-1.armv7hl.rpm209.47 KB19/01/2016 - 00:18
File harbour-passviewer-0.11-1.i486.rpm211.52 KB06/02/2016 - 15:34
File harbour-passviewer-0.11-1.armv7hl.rpm194.71 KB06/02/2016 - 15:34
File harbour-passviewer-1.0-1.i486.rpm212.8 KB17/02/2016 - 23:09
File harbour-passviewer-1.0-1.armv7hl.rpm198.33 KB17/02/2016 - 23:09
File harbour-passviewer-1.1-1.i486.rpm217.46 KB03/04/2016 - 14:03
File harbour-passviewer-1.1-1.armv7hl.rpm202.88 KB03/04/2016 - 14:03
File harbour-passviewer-1.2-1.i486.rpm218.86 KB13/09/2017 - 20:07
File harbour-passviewer-1.2-1.armv7hl.rpm201.39 KB13/09/2017 - 20:07
File harbour-passviewer-1.3-1.i486.rpm228.69 KB07/01/2019 - 20:05
File harbour-passviewer-1.3-1.armv7hl.rpm214.95 KB07/01/2019 - 20:05
File harbour-passviewer-1.4-2.armv7hl.rpm216.54 KB27/01/2019 - 22:06
File harbour-passviewer-1.4-2.i486.rpm229.61 KB27/01/2019 - 22:06

* Sun Jan 27 2019 Christof Bürgi <> 1.4-1
- Complete ZIP64 support
- Autofix slightly faulty JSON in passes so they can be parsed

* Sun Jan 6 2019 Christof Bürgi <> 1.3-1
- Bugfix: Passes without primary fields can now be displayed

* Wed Sep 13 2017 Christof Bürgi <> 1.2-1
- Hungarian translation added (thanks to martonmiklos)
- Landscape mode for tablets added
- GPS is now off when screen is off

* Sun Apr 3 2016 Christof Bürgi <> 1.1-1
- Pass internationalization support
- Partial ZIP64 support (pass files are special ZIP archives)
- Check files without the pkpass extension
- Minor UI tweaks

* Wed Feb 17 2016 Christof Bürgi <> 1.0-1
- Reworked UI to properly handle different screen resolutions
- Proper tablet support (never give up hope!)
- Minor bugs fixed

* Sat Feb 6 2016 Christof Bürgi <> 0.11-1
- Changed to the Nemo Notification API
- Passes can now be opened via CLI or D-Bus
- Improved currency handling
- Lots of code cleanup

* Mon Jan 18 2016 Christof Bürgi <> 0.10-1
- Python code replaced by C++ code
- Inefficient notification handling rewritten
- Russian translation added (thanks to mentaljam)

* Mon Dec 21 2015 Christof Bürgi <> 0.9-1
- Fixed Barcodes with special characters
- App is now more forgiving towards faulty passes
- Swedish translation added (thanks to Åke Engelbrektson)
- Small UI fixes
- High-res Icons added
- Portrait mode deactivated again to avoid problems with some barcode readers

* Wed Oct 14 2015 Christof Bürgi <> 0.8-1
- Preliminary tablet support
- Portrait mode supported
- Code128 barcodes supported
- App registers for PassBook MIME type
- Internal changes to the UI code

* Sun Aug 2 2015 Christof Bürgi <> 0.7-1
- Background images resized, cropped and blurred to avoid confusing scanners
- Currency fields properly formatted
- Minor improvements in pass updates and deletions

* Sun Jul 19 2015 Christof Bürgi <> 0.6-1
- Pass updates implemented
- Fixed crashes caused by faulty passes

* Mon Jun 29 2015 Christof Bürgi <> 0.5-1
- Faster start if SD-card is present

* Thu Jun 25 2015 Christof Bürgi <> 0.4-2
- Fixed notifications remaining visible in OS >= 1.1.6
- Fixed crash of directory scan caused by locked directories

* Sat Jun 20 2015 Christof Bürgi <> 0.4-1
- One may create calendar entries if supported by pass (requires OS >= 1.1.6)
- SD-Cards are now searched for passes, too
- Signature checks removed, as they proved to be tricky and useless

* Fri May 22 2015 Christof Bürgi <> 0.3-1
- Highlighted passes are shown in event view while app is running
- More informative texts in the pass list
- Passes in the pass list are grouped by issuer
- Enlarged primary text in pass view for non boarding passes
- Signatures are now checked

* Sat May 9 2015 Christof Bürgi <> 0.2-1
- New icon courtesy of Moth
- Settings page added
- Passes close to target time or coordinates may be higlighted (check settings)
- Topmost highlighted pass shown on cover, with cover action opening the pass
- Passes may be deleted from the list (deletes the actual file)
- UI fixes


ninepine's picture

Yes agreed @cquence an aarch64 version would be much appreciated please!

cquence's picture

A 64bit version of the app would be great!

will99's picture


I recently had an event where the format for the barcode is missing in the json:

  "barcode": {
    "format": "",
    "message": ":3742",
    "altText": ":3742",
    "messageEncoding": "iso-8859-1"

Maybe instead of not showing any barcode, there should be a fallback code like: code128. I don't know how other viewers behave or maybe there is a standard fallback code...

Anyway, still a very helpful app...



useretail's picture


dfstorm's picture

Thanks for this app :) It work very well (and thanks again for the "full screen code"). If it's not too much to ask I would follow on @cartron comment: adding the date in the list would be a great addition.

cartron's picture

works well, thanks very much! that was very much needed for SFOS.

One request maybe: any way to add the date for the travel? I just have a list with "origine->destination" for train tickets, so I have to click on each pkpass to find the correct one - or maybe allow order to be changed?

p2501's picture

I'll see what I can do in a future release. You gave me an idea or two how to handle this.

llv95dno's picture

Hi again. You might be right that the download from the Exchange-account get distorted somehow. The attachments from both accounts seems to be stored in the Downloads-folder, so no need for adjustment in that aspect. When I compare the files, they are both zip-archives but it seems like there is data missing (not completley empty files) in the attachment at the Exchange-account. Hopefully something can be done Jolla in future updates.

llv95dno's picture

Hi, the app works fine with .pkpass attachment sent to gmail-account configuered on my Xperia X, but it does not seem to find any attachments sent to a MS Exchange-account, but that maybe is as expected. It could be very useful to make it discover attachments in exchange if that could be possible.

p2501's picture

There seems to be a problem with the Sailfish Exchange plugin. With some servers (like some versions of Zimbra), attachements don't get downloaded, just empty files. If that happens, they won't show up in this app.

If you're certain that the attachements get downloaded properly, the problem may be that they end up somewhere in the file system where the app doesn't look for it. I can fix this, but only if I know where to look (I don't have an exchange account, so I can't check myself).

sdiconov's picture

I tried it to see train e-tickets (pdf) but the app does not detect them. What kind of 'passes' does it read? What is it ultimately for? The description is not clear enough. WTF is passbook???

p2501's picture

Passbook is a well known, widespread file format (extension .pkpass). It's commonly used for boarding passes, but also for tickets, loyalty cards and so on. PDFs should show up in the Documents app instead. And no, I won't include a description what Passbook is for the same reason that, say, an ePub Viewer app doesn't explain what ePub is in its description. The app description should be brief and not contain info, that those looking for the app probably know anyway.

BTW: Apple renamed it to Wallet. But as far as I can surmise, that didn't really catch on.

explit's picture

Thanks for the great app! Looking forward some other great features!

cy8aer's picture

I have contrast problems with the application: 33c3 tickets have a black background and there are black fonts are shown. So there is no contrast. The ticket should look like in this tweet (probably an apple device):

p2501's picture

Please send me the offending pass (don't worry, I won't abuse it ;-) ), so I can check why the color is misinterpreted. However, I'm currently mostly afk due to the holiday season, so it might be a while, sorry. You may use the "simple view" option from the pulley menu as a stopgap solution.

zilti's picture

Doesn't find any passes in current SailfishOS version.

p2501's picture

Please try again with the new version. If the problem persists, please give me more info. Otherwise, I can't help.

p2501's picture

Release 0.4-2 should finally fix both the disappearing passes as well as the non-disappearing notifications.

Thanks for the bug reports. After all, I can't fix what I don't know about. ;-)

inte's picture

The latest version doesn't show any passes for me as well. I therefore reverted back to the release on Jolla store, which still finds the passes.

I also have a problem that for some reason I cannot delete pass viewer notifications from the events screen:-(

p2501's picture

Okay, I can reproduce the problem with the undeletable notifications. Apparantly, the behaviour of the notification system changed slightly in the newest OS release, and I need to adapt.

As for the passes not showing, I'm stumped. If anything, the OpenRepos version should show passes that the Harbour version doesn't, not the other way round. Now, petros never sent me a pass, so I couldn't actually check what's wrong. Can you send me one? Thanks.

petros's picture

latest version doesn't show any passes on my jolla!! any idea why?

p2501's picture

There might be a problem with the signature check. Try the "accept faulty signatures" option in the settings.

If this happens to be the problem, please send me a pass (you may use the mail address in the changelog), so I can have a look at it. You may use an old, expired one.

petros's picture

no, that didn't solve the problem. prevous version work fine!

p2501's picture

There was a bug which rendered the "accept faulty signatures" option useless. Please try again.

If it works now, there still probably is a problem with the signature check.

Moth's picture

Can't get this idea out of my head, sorry... :-)

Nokius's picture

realy nice icon!!!!!!!

Mariusmssj's picture

great icon for a great app

nodevel's picture

Wow, IMHO this is the best SailfishOS icon yet.

heubergen's picture

Great work, thanks!