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
File harbour-passviewer-1.4-2.aarch64.rpm235.37 KB18/07/2021 - 11:14

* 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


maier's picture

Thank you!

ninepine's picture

Fixed thanks!

p2501's picture

Good to know. Thanks! As I don't have a 64-bit device, I can't test the 64-bit packages myself.

In case anybody wonders: The package accidentally asked for both the 64-bit version and the 32-bit version of libbz2. Only the 64-bit version is present (and actually required).

baxyz's picture

Same here X-D

ninepine's picture

Nothing provides

p2501's picture is on the list of allowed required libraries. It should be in the system repo and automatically installed. Looks like it's missing. I also submitted the 64-bit version to the Harbour. Let's see what they say.

If there is no other quick solution, I might also patch out the BZip2 support for now. I don't think the BZip2 compression is in actual use in passes, so the feature probably isn't needed anyway.

slava's picture

On my 64-bit device:

[root@Xperia10II-DualSIM ~]# rpm -ql --requires -p /tmp/harbour-passviewer-1.4-2.aarch64.rpm | grep libbz2
[root@Xperia10II-DualSIM ~]# rpm -q --provides bzip2-libs
bzip2-libs = 1.0.8+git1-1.1.38.jolla
bzip2-libs(aarch-64) = 1.0.8+git1-1.1.38.jolla
[root@Xperia10II-DualSIM ~]# 

bzip2-libs doesn't provide

You're probably adding this dependency manually. Don't do that, let rpmbuild to figure it out.

p2501's picture

You are correct. There where still manual REQUIRE entries from way back. I removed them, rebuilt and replaced the package. Please try again.

slava's picture

It does install now.

baxyz's picture

Same here

ninepine's picture

Getting an error when trying to install the aarch64 on Xpedia 10ii. Will try again after a refresh



p2501's picture

I'm currently bogged down. However, I should be able to resume work on this app mid July (this year ;-) ). Next version will mostly be technical changes for the current versions of SailfishOS, but also some UI upgrades.

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...



p2501's picture

I guess I could default to QR-Codes (as they are the most common type).

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.