Metrodroid
Read data from public transit cards using your NFC Android phone! (iOS 13 and PC/SC support coming soon)
Install / Use
/learn @metrodroid/MetrodroidREADME
Metrodroid
[][weblate] [
][travis]
Version: 3.1.0
View remaining balance, recent trips, and other info from contactless public transit cards using NFC on Android and [iOS (coming soon)][ios].
View the presentation of work undergone to support a number of Australian agencies' cards, given at linux.conf.au 2018, in the talk Tap on to reverse engineering.
Thanks to
- [Eric Butler][5] (Farebot, on which this project is based)
- [Karl Koscher][3] (ORCA)
- [Sean Cross][4] (CEPAS/EZ-Link)
- Anonymous Contributor (Clipper)
- [nfc-felica][13] and [IC SFCard Fan][14] projects (Suica)
- Chris Norden (Edy)
- Wilbert Duijvenvoorde (MIFARE Classic/OV-chipkaart)
- tbonang (NETS FlashPay)
- Marcelo Liberato (Bilhete Único)
- Lauri Andler (HSL)
- Michael (Opal, Manly Fast Ferry, Go card, Myki, Octopus, Cubic Nextfare, LAX TAP, SmartRider, MyWay, MIFARE Ultralight, ERG, Christchurch Metrocard)
- Steven Steiner (LAX TAP)
- Rob O'Regan (Manly Fast Ferry card image)
- [The Noun Project][15] (Various icons)
- Vladimir Serbinenko (Podorozhnik, Troika, Compass, Shenzhen Tong, Rav-Kav, T-money, Leap, CharlieCard, EN1545, Intercode, IstanbulKart, Lisboa Viva, Mobib, RicaricaMi, Chinese cards, Adelaide Metrocard, Rejsekort)
- Toomas Losin (Compass)
- Sinpo Lib (Shenzhen Tong)
- Maria Komar (Podorozhnik database and dumps)
- Bondan Sumbodo (Kartu Multi Trip, MRT Jakarta)
Translated by
Thanks to those who have [helped to make Metrodroid available in languages other than English][weblate]:
- Dutch: Vistaus
- Finnish: Lari Oesch, Lauri Andler
- French: Albirew
- Hebrew: Steven Steiner, Yaron Shahrabani
- Indonesian: Bondan Sumbodo
- Japanese: naofum, Chris Norden, [Eric Butler][5]
- Kabyle: belkacem77, aqvayli
- Norwegian Bokmål: Allan Nordhøy, Petter Reinholdtsen
- Portuguese (Brazil): Marlon Colhado
- Russian: Vladimir Serbinenko
- Spanish: NokisDemox
- Turkish: omersiar
Supported card protocols
- [FeliCa][felica]
- [FeliCa Lite][felica]
- ISO/IEC 7816-4
- [Calypso][calypso]
- [CEPAS][cepas]
- [T-Money][tmoney]
- [ISO/IEC 15693 "Vicinity"][nfcv]
- [MIFARE Classic][mfc] (Not compatible with all devices)
- [MIFARE DESFire][mfd]
- [MIFARE Ultralight][mfu] (Not compatible with all devices)
Supported cards / agencies
| Card / Agency | Location | Notes |
|------------------------------------------------|----------------------------------------------------------------------------|-----------------------------------------|
| [Amiibo][amiibo] | :earth_asia: worldwide | :new: IOS |
| [AT HOP][athop] | :new_zealand: Auckland, New Zealand | :new: :id: IOS |
| [Beijing Municipal Card][beijing] | :cn: Beijing, China | :new: |
| [bip!][bip] | :chile: Santiago de Chile, Chile | :new: :closed_lock_with_key: MFC |
| [Bilhete Único][bu] | :brazil: São Paulo, Brazil | :closed_lock_with_key: MFC |
| [BUS-IT][busit] | :new_zealand: Greater Hamilton (Waikato), New Zealand | :new: :closed_lock_with_key: MFC |
| [Carta Mobile][pisa] | :it: Pisa, Italy | :new: IOS |
| [CharlieCard][charlie] | :us: Boston, MA, USA | :new: :closed_lock_with_key: MFC |
| Cifial | :earth_africa: worldwide | :new: MFC |
| City Union | :cn: Mainland China | :new: IOS |
| [Clipper][clipper] | :us: San Francisco, CA, USA | IOS |
| [Compass][compass] | :canada: Vancouver, BC, Canada | :new: :one: IOS |
| [Crimea Trolleybus][crimea] | Crimea | :new: :closed_lock_with_key: MFC |
| [Cubic Nextfare][nextfare] | :earth_americas: many locations | :new: :closed_lock_with_key: MFC |
| [EasyCard][easycard] | Taipei | :closed_lock_with_key: MFC |
| [Edy][edy] | :jp: Japan | |
| [Ekarta][ekarta] | :ru: Ekaterinburg, Russia | :new: :closed_lock_with_key: MFC |
| [Electronic Barnaul][barnaul] | :ru: Barnaul, Russia | :new: :closed_lock_with_key: MFC |
| [EMV][emv] | :earth_africa: worldwide | :new: |
| [Envibus][envibus] | :fr: Sophia Antipolis, France | :new: IOS |
| [ERG][erg] | :earth_asia: many locations | :new: :closed_lock_with_key: MFC |
| [EZ-Link][ezlink] | :singapore: Singapore | |
| [Go card][seqgo] | :australia: Brisbane and South East Queensland, Australia | :new: :closed_lock_with_key: MFC |
| [GoCard][otago] | :new_zealand: Otago, including Greater Dunedin and Queenstown, New Zealand | :new: MFC |
| [Go-to card][mspgoto] | :us: Minneapolis-St. Paul, MN, USA | :new: :closed_lock_with_key: MFC |
| [Hafilat][] | :united_arab_emirates: Abu Dhabi, UAE | :new: IOS |
| [HOLO][holo] | :us: Oʻahu, HI, USA | :new: :id: IOS |
| [Hop Fastpass][hfp] | :us: Portland, OR, USA | :new: :id: IOS |
| [HSL][hsl], [Matkakortti][matka], [Waltti][] | :finland: Finland | IOS |
| [IstanbulKart][istanbul] | :tr: Istanbul, Turkey | :new: :id: IOS |
| [Kartu Multi Trip][kmt] | :indonesia: Jakarta, Indonesia | KMT IOS |
| [Kazan transport card][kazan] | :ru: Kazan, Russia
