A fediverse bot to look up Magic: The Gathering cards
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Holly McFarland f88fab0431 Flesh out readme 10 months ago
.gitignore Include command line flag to repost pinned thread 10 months ago
LICENSE Initial commit 1 year ago
README.md Flesh out readme 10 months ago
config.sample.py Handles opting in/out and listens for statuses from opted in accounts 1 year ago
debug.py fix a stray import 1 year ago
easter_eggs.py Refactor easter eggs into a separate file 11 months ago
example-garruk.png Flesh out readme 10 months ago
example-lotus.png Flesh out readme 10 months ago
face.py Fix broken DFC support 11 months ago
mtgcardlookup.py Include command line flag to repost pinned thread 10 months ago
mtgcardlookup.service Flesh out readme 10 months ago
requirements.txt Add requirements.txt to install prereqs with 10 months ago



A fediverse bot to look up Magic: The Gathering cards.

To use, mention the bot with a message that contains at least one Magic card name wrapped in either square brackets or {{curly braces}}. It will search Scryfall for the card and reply with the result. Alternatively, follow the bot, and it will follow you back. Any posts it sees with that syntax in its home timeline will also be processed.

See it in action here!


  • Automatically keeps its follower and following lists synced
    • Follows back accounts instantly, unfollows every 5 minutes (API restriction)
  • If four or less cards are requested, includes images of each card with Oracle text in the description
    • Double Faced Card images are handled by combining both faces into a single image
  • Uses fuzzy searching to correct shortenings where possible
  • Replies at the same privacy level as it was called with, or unlisted, whichever is more restrictive
  • Includes pinned status management (see "Installation and Setup")
    • Unpins all current statuses, then posts a pre-written thread and pins each new status in reverse order

Installation and Setup

  • Clone this repository and create a python environment however you like to
  • Install dependencies with pip install -r requirements.txt
  • Install and enable the included mtgcardlookup.service with systemd, replacing the ExecStart, WorkingDirectory, and User values with those for your system
  • [OPTIONAL] Write an introduction thread to be pinned
    • Create a new file called pinned_thread.txt
    • Write each status of the introduction thread, separated by \n-----\n
    • Run ./mtgcardlookup --update-pins. The thread will be posted and pinned
    • In the future, you can modify pinned_thread.txt and rerun the command. The existing thread will be unpinned and the modified one will be posted and pinned.