hermes

README

Hermes

Hermes is a tool to own your data. It can parse exported data from different sources and collect them in a JSON, Obsidian flavoured markdown, or SQLite/remote Datasette format on your own computer.

Partially ✨Vibe coded✨ with Cursor, Claude Code and Cline

Key Features

• Export to Markdown, JSON, and SQLite
• Optional remote export to a Datasette instance for querying and sharing

Documentation

Comprehensive documentation is available in the docs/ directory:

• Project Overview
• Installation & Setup
• Architecture
• Configuration
• Output Formats
• Caching
• Logging & Error Handling

Importers

• Goodreads Importer
• IMDb Importer
• Letterboxd Importer
• Steam Importer

Utilities

• Command Utilities
• Configuration Utilities
• Error Utilities
• File Utilities

Sources

• ✅ Imdb "Your ratings" import
  • Data enriched from OMDB
• ✅ Letterboxd using data export
  • Data enriched from OMDB
  • Automated export via hermes import letterboxd --automated (Chrome/Chromium required)
• ✅ Goodreads
  • Data enriched from openlibrary
  • Automated export via hermes import goodreads --automated (Chrome/Chromium required)
• ✅ Steam
  • Uses Steam API to fetch list of games you own (BYO Steam API key)
  • Game data enriched via Steam API

Commands

Enhance

Enrich existing Obsidian markdown notes with TMDB metadata:

hermes enhance --input-dirs ./markdown/movies --recursive

Or configure default enhance directories/options in config.yml and run:

hermes enhance

See docs/04_configuration.md for configuration options.

Diff

Compare imported data between sources:

# Generate markdown diff report
hermes diff imdb-letterboxd

# Generate HTML report
hermes diff imdb-letterboxd --html diff.html

See docs/08_diff.md for details.

Other

Most API data is cached locally just to be a good API citizen

• Initial Steam import might take a while, you need to restart every few hours
• OMDB has a 1k/day limit, so bigger lists may take a few days to fully process

Documentation

Overview

Copyright © 2024 NAME HERE <EMAIL ADDRESS>