Skip to content

belohoub/UBcards

Repository files navigation

UBcards for Ubuntu-Touch (UBports)

This application is still in testing, please comment on existing issues or open a new one if something goes wrong, if you found a bug, or if you wish a new feature.

UBcards is a simple card wallet application for Ubuntu Touch. UBcards allows managing the barcode-based (loyalty) cards. Cards could be scanned by the phone camera or inserted manually.

UBcards follows the philosophy of the older Card Wallet application, preserving its simplicity, while adding few new features like icons for easier view in the longer card list, or direct barcode scanning.

OpenStore

UBcards

Migrating from the Card Wallet App

UBcards allows you to import your cards from the Card Wallet application if you come from Xenial to Focal using a simple shell script.

The migration is allowed by the shell script, not by the UI. This is because the application isolation complicates the implementation and yes, I'm lazy, and I hope this one-time step is OK for most users :-)

To import cards from the Card Wallet app, execute the following script on your Ubuntu-Touch device:

$ cat ~/.local/share/ubcards/wallet.ini
$ bash /opt/click.ubuntu.com/ubcards/current/import/import_cardwallet.sh 
Create a backup of the wallet: 
Getting data from the Card Wallet: 
  - processing: Tesco, ... , 1, CODE-128
  - processing: Billa, ... , 3, EAN-13
  - processing: Sportisimo, ... , 3, EAN-13
  - processing: IEEE, ... , 6, CODE-39
Done!
$ cat ~/.local/share/ubcards/wallet.ini

Then re-open the UBcards app and check if the import was successful. In case of any issues, you can get back to the previous configuration:

$ cp ~/.local/share/ubcards/wallet.ini~ ~/.local/share/ubcards/wallet.ini

Project History

UBcards follows the philosophy of the older Card Wallet application, preserving its simplicity, while adding a few new features like icons for easier view in the longer card list, or direct barcode scanning.

The subset of Card Wallets' code is re-used in UBcards, while UBcards is the extensively reworked fork of the Tagger application from which it inherits e.g. the barcode scanning features.

The overall code evolution is briefly documented in the changelog.

Credits

I would like to thank several projects/persons:

  1. Tagger for a great application. This app is actually a fork of Tagger
  2. Card Wallet for a great application, re-used code snippets, and fonts
  3. Fonticons, Inc. for the Font Awesome Icons
  4. Sam Hewitt, Suru Icons for the initial graphics used to create the application logo
  5. UBsync for experience with development for Ubuntu-Touch

Current and Past Contributors

Contribute

Please use the issue tracker to report a bug or request a new feature. Any help on the code is welcome to enhance the app!

The code is currently still filled by the unnecessary code inherited from the Tagger - it will need further cleanup.

Please see the following issues to discuss the proposed features:

Translations

For translation instructions please read this page from the docs.

In short, this app currently does not use a translation service. So you will need to either create or edit the .po file for your language and commit this new/changed .po file as a pull request.

Documentation