TiddlyWiki Media Importer

A TiddlyWiki 5 plugin that serves as a unified media manager for Books, Comics, Games, Manga, Movies, and TV Shows. It fetches metadata from various public APIs and formats them into rich Tiddlers with cover images, descriptions, and ratings.

Features

• Unified Search Interface: Search across multiple media types from a single dashboard.
• Rich Metadata: Imports titles, release dates, authors/creators, genres, plots, and cover images.
• Library Dashboard: A built-in library view to filter and sort your collection by status (Backlog, Active, Completed, Dropped), rating, and year.
• Custom View Template: Displays media tiddlers with a specialized layout including a sidebar for the poster and rating.

Supported Services

Media Type	Source API	API Key Required?
Books	OpenLibrary	❌ No
Comics	ComicVine	✅ Yes
Games	RAWG	✅ Yes
Manga	AniList	❌ No
Movies	TMDB	✅ Yes
TV Shows	TMDB	✅ Yes

Installation

TiddlyWiki

1. Go to https://mblackman.github.io/tiddlywiki-media-importer/
2. Scroll down to the tiddler $:/plugins/mblackman/media-importer
3. Drag and drop the tiddler into your TiddlyWiki.

GitHub

1. Go to the Releases page.
2. Download the media-importer.json file from the latest release.
3. Drag and drop the file into your TiddlyWiki.
4. Click Import.
5. Save and Reload your TiddlyWiki.

Configuration

Some importers require free API keys to function.

1. Open the Control Panel in your TiddlyWiki.
2. Navigate to the Settings tab, then look for Media Importer.
3. Enter your API keys for the services you wish to use:
   • ComicVine: Get Key
   • RAWG: Get Key
   • TMDB: Get Key

Usage

1. Create a media importer tiddler and add the text: {{$:/plugins/mblackman/media-importer/ui}}.
2. Select the tab for the media type you want to add (e.g., Book, Movie).
3. Type the title and press Enter or click Search.
4. Click Import on the desired result.
5. The item is added to your wiki and opened automatically.

License

MIT