"Tabor" is Polish for rolling stock. Warsaw runs about 2 600 buses and trams
in regular service, split across 44 models. Some models have hundreds of
vehicles, and some have four. On top of that come 36 kinds of museum and club
vehicles, Tramwaje Warszawskie's works cars, and the odd bus on trial. Every vehicle carries a fleet number, and
ZTM's database says which model each number belongs to. So a photo of a bus is
enough to know exactly what you've seen, and a list of every number is enough to
know what you haven't.
TABOR does both halves. CATCH reads the fleet number off your photo, on the
phone. BOOK files the vehicle under its model and batch. HUNT
shows every vehicle you haven't caught yet, live, on a map, and follows one to
your stop on the Lock Screen. ME keeps the score.
Install
Get it on the App Store: apps.apple.com/app/tabor/id6816408610
(iPhone, iOS 18 or later, free). Bug reports and ideas go in
issues, and questions in
discussions.
CONTRIBUTING.md says what makes a report or a pull request easy to act on.
Po polsku: opis i instalacja na thefilip.com/tabor.
Or build it yourself. Open the project in Xcode 27 and run it on your phone:
open Tabor.xcodeproj
Set your own team under Signing & Capabilities for the Tabor, TaborControls
and TaborShare targets.
The live map and the live-assisted number reading use Warsaw's open data. The
app doesn't carry a key: it asks TABOR's proxy (proxy/, a Cloudflare Worker
running in Warsaw), which holds the key, keeps each copy of the feed for 3
seconds so phones share one call to the city, gzips it, and allows each address
60 calls a minute. Builds from this repo use that proxy as they are. To go
direct instead, paste a free key from
dane.um.warszawa.pl into Settings › Live data. To
run your own proxy, change the domain in proxy/wrangler.toml and
TABOR_LIVE_PROXY in Config/Tabor.xcconfig, then:
cd proxy && npx wrangler secret put DANE_TOKEN && npx wrangler deploy
CATCH
- The number is read from the shot. Take the photo and Vision's text
recogniser reads the part inside the brackets, on the phone. If the whole
frame gives nothing, or only a short number, it's read again as nine
overlapping tiles, so a small number on a whole-vehicle shot has enough
pixels. The live preview isn't read at all: that only cost battery and heat,
and you can see the bus coming anyway.
- Only fleet numbers count. A photo of a bus is full of other digits: line
numbers, times on the destination display, and the registration plate.
- Runs glued to letters are dropped, and so are runs after a two- or three-letter
county code (
WX 2043F, WPI 12345), and plate digits that start with 0.
"Nr 1974" still counts, and so does a number with paint glued on.
- Times and decimals (
20:15, 3.14) are dropped.
- A number the database doesn't know is only kept if it's four digits long.
- One letter that looks like a digit (
1O23, I974) is read as that digit, but
only when that makes a number in the fleet, and it ranks below a clean read.
- When a photo shows only a short number, it's read again more closely, so a
line number isn't taken for the fleet number.
- It knows what's around you. With a location fix and the live feed, a number
that belongs to a vehicle within 300 m gets a boost. If the read is one digit
off a vehicle within 150 m (OCR turning 4235 into 1235), that vehicle is
offered too, though a clean read of a real number still wins. When a number
belongs to both a bus and a tram, whichever one is actually nearby settles it
(otherwise the reveal asks which one it is), and the catch gets its line
number from the feed.
- More than one in the shot. Other vehicles in the photo are offered on the
reveal as chips ("+ 5918 · ALSO IN SHOT"), each with its own sticker, and saved
as catches of their own. With the live feed they have to be running nearby.
- Coupled trams count twice. Konstal 105Na, 105N2k and Cegielski 123N run as
two cars, each with its own number, but the live feed reports a set under one
of them. So the other car isn't "fixed" into its neighbour: it's kept as read,
and it takes the set's line. The reveal offers + SECOND CAR, suggesting the
other number (from the photo, the feed or the next number along), and both cars
go in the book.
- BUS / TRAM / AUTO is a preference, not a filter. A bus number read in TRAM
mode still matches the bus. Spotters forget to switch back.
- The shot is what you framed. The viewfinder is a 3:2 photo frame, and the
saved shot is cropped to it. Zoom has one button per real lens (0.5×, 1×, 2×,
5× on a 16 Pro), so 5× is the telephoto rather than a crop of the main lens, and
the phone clicks as you cross from one lens to the next. The last button goes to
twice the longest lens (10× on a 16 Pro), for a bus that's already pulling away.
This is the beginning of the README. Read the rest at the original. Read the full README ↗
