Skip to content

Install

Fathom runs on Linux and Windows today. Each download is self-contained: libmpv and the media codecs are bundled, so there is nothing else to install.

Grab the newest build from the Releases page.

Linux (AppImage)

Fathom ships two Linux AppImages. Pick the one matching your CPU:

  • Fathom-x86_64.AppImage for a normal PC (Intel / AMD).
  • Fathom-aarch64.AppImage for ARM64 machines (Asahi Linux on Apple silicon, Raspberry Pi, and similar).

Download it, make it executable, and run it:

chmod +x Fathom-x86_64.AppImage
./Fathom-x86_64.AppImage

Run it with ./, not .\

That is a forward slash. .\Fathom-x86_64.AppImage is Windows/PowerShell syntax and will fail in a Linux shell with command not found.

If it will not launch

An AppImage needs FUSE. On distributions that ship only fuse3 (Arch, for example), either install the compatibility library or run without FUSE:

sudo pacman -S fuse2                     # or your distro's equivalent
./Fathom-x86_64.AppImage --appimage-extract-and-run

See Troubleshooting for the full list of launch fixes.

Once it runs, Fathom can keep itself up to date. See Updates and channels.

Windows

Download Fathom-windows-x64.zip, extract it, and run fathom.exe. It is self-contained, with nothing else to install.

Android

Planned. Fathom is built with Flutter, so an Android build is on the roadmap.

macOS and iOS

Not available yet. Building for either needs Mac hardware (and, for iOS, a paid Apple Developer account). If you would like to see Fathom on Apple platforms, a Ko-fi toward that hardware helps.

Build from source

You need the Flutter SDK. Then:

flutter pub get
flutter build linux --release      # or: flutter build windows --release

ffmpeg is recommended but optional: it merges YouTube's separate video and audio streams when you download in higher quality. Everything else works without it.

For the packaged, self-contained AppImage (libmpv bundled), see tool/build_appimage.sh and the Contributing guide.