git404hub

what is flipper-tunion fr?

eternal-flame-ad/flipper-tunion — explained in plain English

Analysis updated 2026-07-18 · repo last pushed 2026-05-16

CAudience · developerComplexity · 2/5MaintainedSetup · moderate

tl;dr

A Flipper Zero plugin that reads China T-Union transit cards, showing your balance, trip history, and card details directly on the device.

vibe map

mindmap
  root((repo))
    What it does
      Reads T-Union cards
      Shows balance and dates
      Displays ride history
    Use cases
      Check card balance
      Audit trip logs
      Explore card data
    Tech stack
      C language
      Flipper Zero
      NFC contactless
    Audience
      Hardware hobbyists
      Security researchers
      Transit riders
    Design goals
      Fast load times
      Works any firmware
      Small footprint

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

what do people make with this?

VIBE 1

Check your transit card balance and recent trip history on a Flipper Zero.

VIBE 2

Audit trip logs to verify when you tapped in and out of transit gates.

VIBE 3

Experiment with LED-equipped T-Union cards using the NFC field tool.

what's the stack?

CFlipper ZeroNFC

how it stacks up fr

eternal-flame-ad/flipper-tunionacc4github/kdenlive-omnifadeaggarg/freertos-kernel-partner-supported-ports
Stars0
LanguageCCC
Last pushed2026-05-162025-03-19
MaintenanceMaintainedStale
Setup difficultymoderatemoderatemoderate
Complexity2/52/53/5
Audiencedevelopergeneraldeveloper

Figures from each repo's GitHub metadata at analysis time.

how do i run it?

Difficulty · moderate time til it works · 30min

Requires a Flipper Zero device and a China T-Union transit card to test with.

in plain english

flipper-tunion is a plugin for the Flipper Zero, the pocket-sized multi-tool popular with hardware tinkerers. It reads China T-Union transit cards, the contactless smart cards used for buses, rail, and other public transit across many Chinese cities. If you have a card from that system and want to inspect what's stored on it, this tool lets you do that directly on the Flipper device. When you tap a card with the Flipper, the plugin reads the data and displays a straightforward breakdown. You can see the card's primary account number, its issue and expiration dates, the region and city it belongs to, and the current remaining balance. It also pulls up ride history, showing timestamps for when you tapped in and out of transit gates, plus a log of recent transactions. There's additionally an NFC field tool for experimenting with LED-equipped cards, such as a special edition card from the Liaodong Peninsula. This is useful for anyone curious about what's happening behind the scenes when they tap a transit card. Transit operators, security researchers, and hardware hobbyists who ride transit in China can use it to verify card balances, audit trip logs, or explore how the card communicates with readers. It's a practical tool for anyone who wants transparency into a card they carry every day. The plugin is written in C with a simple text-based interface, designed to work with any Flipper firmware rather than requiring a specific custom build. The author notes another project in the same space that has a richer interface and a station name database, but this one prioritizes fast load times and a small footprint. It trades polish for speed and broad compatibility, which makes sense for a quick-check tool you'd run on a portable device.

prompts (copy fr)

prompt 1
Help me install the flipper-tunion plugin on my Flipper Zero so I can read my China T-Union transit card.
prompt 2
Walk me through what the card details mean when I tap my T-Union card, PAN, region, city, issue date, and balance.
prompt 3
I tapped my transit card and got ride history with timestamps. Help me understand the tap-in and tap-out entries.
prompt 4
Show me how to use the NFC field tool in flipper-tunion to experiment with my LED-equipped Liaodong Peninsula card.

Frequently asked questions

what is flipper-tunion fr?

A Flipper Zero plugin that reads China T-Union transit cards, showing your balance, trip history, and card details directly on the device.

What language is flipper-tunion written in?

Mainly C. The stack also includes C, Flipper Zero, NFC.

Is flipper-tunion actively maintained?

Maintained — commit in last 6 months (last push 2026-05-16).

How hard is flipper-tunion to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is flipper-tunion for?

Mainly developer.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.