Medeia-Macina

A powerful CLI media management and search platform integrating local files, Hydrus, torrents, books, and P2P networks.

Key Features

• Unified Search: Search across Local, Hydrus, LibGen, Soulseek, and Debrid.
• Pipeline Architecture: Chain commands like PowerShell (e.g., search | filter | download).
• Smart Selection: Use @N syntax to interact with results.
• Metadata Management: Tagging, notes, and relationships.

Installation

1. Install Python 3.9+ and Deno (for YouTube support).
2. Install dependencies: pip install -r requirements.txt
3. Run the CLI: python CLI.py

Command Examples

Search & Download

# Search and download the first result
search-file "daughter" | @1 | download-data

# Search specific provider and download
search-file -provider libgen "dune" | @1 | download-data

# Download YouTube video (auto-probes formats)
download-data "https://youtube.com/watch?v=..."
# Select format #2 from the list
@2 | download-data

File Management

# Add file to Hydrus
add-file -path "C:\Videos\movie.mp4" -storage hydrus

# Upload to 0x0.st and associate URL with Hydrus file
search-file "my_video" | @1 | add-file -provider 0x0

# Add tags to a file
search-file "video" | @1 | add-tag "creator:someone, character:hero"

# Use tag lists (from helper/adjective.json)
@1 | add-tag "{gnostic}"

Metadata & Notes

# Add a note
search-file "doc" | @1 | add-note "comment" "This is important"

# Get tags
search-file "image" | @1 | get-tag

Pipeline Syntax

• | : Pipe results from one command to another.
• @N : Select the Nth item from the previous result (e.g., @1).
• @N-M : Select a range (e.g., @1-5).
• @{1,3,5} : Select specific items.
• @* : Select all items.

Configuration

Edit config.json to set API keys (AllDebrid, OpenAI), storage paths, and Hydrus credentials.