TraceAnime

Language: EN | RU | FR

macOS menu bar anime frame search

TraceAnime sits in the macOS menu bar and finds anime scenes from an image or video frame through the trace.moe API.

It accepts an image URL, the latest image from the clipboard, a dragged image, or a file selected from disk. Results include anime metadata, timestamps, previews, history, favorites, quota information, and multilingual UI.

Features

• Menu bar-only macOS interface.
• Search by image URL, clipboard image, drag and drop, local file, or screen-area capture with a configurable global hotkey.
• Inline preview playback for search results.
• Open matches on AniList or MyAnimeList, copy result details, drag the frame out, or share it.
• Favorites and search history (configurable size, per-entry delete and clear all) keeping the original searched image.
• trace.moe quota view and optional API token.
• Update notice when a newer release is available.
• Launch at login.
• English, Russian, and French UI.
• BSD 3-Clause open-source license.

Requirements

• macOS 14 or later.
• Xcode Command Line Tools.
• Network access to api.trace.moe.

Build

swift build

Run as an app bundle

./script/build_and_run.sh

The script builds the SwiftPM executable, generates the app icon, creates an ad-hoc signed dist/TraceAnime.app, and opens it.

Build a release DMG

./script/build_dmg.sh

The release script creates dist/TraceAnime.dmg with an ad-hoc signed app bundle and a drag-to-Applications layout.

Install from GitHub Releases

This build uses ad-hoc signing. Since Apple has not notarized it and no Apple Developer ID certificate signs it, macOS Gatekeeper may block the first launch after you download the DMG from GitHub.

To open the app:

1. Download TraceAnime.dmg from Releases.
2. Open the DMG and drag TraceAnime.app to Applications.
3. In Finder, right-click TraceAnime.app and choose Open.
4. Confirm Open in the macOS security prompt.

You only need this on the first launch. Releases that open without this prompt require an Apple Developer ID certificate and Apple notarization.

Notes

• The trace.moe token is optional and is stored in app settings.
• Generated build artifacts are ignored by Git.
• This project is not affiliated with trace.moe or AniList.

License

TraceAnime is released under the BSD 3-Clause License.