Fathom 0.2.1

Fathom 0.2.1 fixes the F-Droid listing icon and moves both channels to build
10. There are no app behaviour changes.

Fixed

• F-Droid now has a raster launcher icon at every density. 0.2.0's APK
  contained only the adaptive-icon XML, which fdroidserver does not render, so
  the listing had no icon.

Install

• iPhone and iPad: add the AltStore Classic source at
  https://fathom.ewancroft.uk/altstore/source.json.
• Android: add the F-Droid repo at
  https://fathom.ewancroft.uk/fdroid/repo.

Direct APK and IPA downloads are attached to this release. There is no App
Store or Google Play listing.

The apps have been run against a real account on an Android emulator and an
iOS simulator, not on physical hardware. The Android APK is signed with the
Fathom release key; the AltStore IPA is unsigned on purpose and is re-signed by
AltStore Classic.

The name

A fathom is a unit of depth, and to fathom something is to understand it.
Fathom does both: it measures a listening history and makes the record
underneath it legible, while leaving that record in your own repository.

Fathom 0.2.0

Fathom 0.2.0 is the first tagged, signed release, distributed through AltStore
Classic and a self-hosted F-Droid repo. It followed the 0.1.0 development
snapshot.

Install

• iPhone and iPad: add the AltStore Classic source at
  https://fathom.ewancroft.uk/altstore/source.json. AltStore Classic signs the
  unsigned IPA with your own Apple ID.
• Android: add the F-Droid repo at
  https://fathom.ewancroft.uk/fdroid/repo. The install link on the website
  includes the repo index fingerprint.
• Direct APK and IPA downloads are attached to this release.

There is no App Store or Google Play listing.

What changed

• Added History search over track, artist and release, implemented once in the
  shared Kotlin core.
• Added the History month jump and a match count that distinguishes no matches
  from no plays.
• Added About with the actual bundle version, the AGPL-3.0 text, third-party
  notices and legal links.
• Added the public website, privacy policy and terms, now served at
  https://fathom.ewancroft.uk.
• Added the unified release contract: local signing, one v0.2.0 GitHub
  Release, and CI provenance for the exact published bytes.
• Added AltStore Classic and F-Droid channel files, with separate app-signing
  and repo-index keys.

Verification and limitations

The apps have been run against a real account on an Android emulator and an
iOS simulator. They have not been smoke-tested on physical hardware. The
Android APK is signed with the Fathom release key. The AltStore IPA is unsigned
on purpose; AltStore Classic re-signs it on install. The F-Droid repo index is
signed with a separate, offline repo key.

The name

A fathom is a unit of depth, and to fathom something is to understand it.
Fathom does both: it measures a listening history and makes the record
underneath it legible, while leaving that record in your own repository.

Fathom 0.1.0

Fathom 0.1.0 is the source-only pre-release that preceded the first tagged
build. It is listed for the record, not for installation: no release APK or IPA
was produced, and no GitHub Release was published at the time.

The snapshot is commit 923375c, the last commit whose version.properties
reports 0.1.0 (8). It contains the four-screen dashboard, the shared Kotlin
core, the public website and the release tooling that 0.2.0 would use.

Install

There is no 0.1.0 binary. Install the current signed release from
https://fathom.ewancroft.uk, or download its APK and IPA from the
0.2.1 release. The
first installable release was 0.2.0.

What it established

• Now, Stats, History and Profile, all reading one history from the account's
  PDS.
• The shared Kotlin core for record decoding, XRPC paging and listening
  statistics.
• Read-only operation: no account, password, token or Fathom backend.
• Progressive reads, a saved local history and partial-read labelling.
• A public website with the landing page, privacy policy and terms.
• The version source and release scripts that the later signed releases use.

Verification

This is a historical source marker, not a tested artifact. No 0.1.0 binary or
provenance attestation survives. Use the
0.2.1 release for a
verified build.

The name

A fathom is a unit of depth, and to fathom something is to understand it.
Fathom does both: it measures a listening history and makes the record
underneath it legible, while leaving that record in your own repository.

Fathom 0.2.0 development preview

Fathom 0.2.0 development preview

This is an Android development preview, not a signed store release. It was
built from commit 38cc625 and reports version 0.2.0 (9). It is preserved as
the first public preview; 0.2.0 and 0.2.1 have since shipped as signed
releases.

What is included

• History search over track, artist and release, with case- and
  diacritic-insensitive matching shared by both platforms.
• A month jump in History, match counts, and a No date section for plays
  with no readable timestamp.
• An About section on both platforms with the installed version and build
  number, source link, privacy and terms links, the bundled AGPL-3.0 text and
  third-party notices.
• A public website with the landing page, privacy policy and terms.
• A tag-driven release workflow that checks the tag against
  version.properties and publishes signed artifacts when the release
  environment has its signing secrets.

Install (Android)

Download Fathom-0.2.0-9-debug.apk and install it on Android 8.0 (API 26) or
later. The application ID is uk.ewancroft.fathom.debug, so it can sit beside
the current signed app.

This is a debug build signed with the standard Android debug key. It is not
store-ready, cannot be upgraded to a signed build, and should be uninstalled
before installing one. The source is the authoritative artifact.

Not included

• No iOS IPA in this preview. At the time, there was no Apple Distribution
  certificate or provisioning profile in the release environment.
• No store-signed AAB, APK or IPA. The only artifact is the debug-signed
  APK above; the tag workflow was waiting for those secrets.
• No Play or TestFlight upload. The store records and credentials did not
  exist yet.

Verification

• ./gradlew :shared:jvmTest :app:testDebugUnitTest :app:assembleDebug
  passed locally.
• xcodebuild test -scheme Fathom -only-testing:FathomTests passed on the
  iPhone simulator.
• CI run 42535560602 passed for commit 38cc6258.
• The APK reports uk.ewancroft.fathom.debug, version 0.2.0 (9) via aapt.
• SHA256SUMS is attached; compare it before installing.

For a current, signed install, use the
0.2.1 release.

The name

A fathom is a unit of depth, and to fathom something is to understand it.
Fathom does both: it measures a listening history and makes the record
underneath it legible, while leaving that record in your own repository.