65 lines
1.9 KiB
Markdown
65 lines
1.9 KiB
Markdown
|
# 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.
|