AST

README copy.md

@@ -0,0 +1,64 @@
+# 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.