Medios-Macina/README.md

# 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](https://deno.com/) (for YouTube support).
2.  Install dependencies: `pip install -r requirements.txt`
3.  Run the CLI: `python CLI.py`

## Command Examples

### Search & Download
```powershell
# 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
```powershell
# 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
```powershell
# 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.