Medios-Macina/README.md

# Medios-Macina
- Audio
- Video
- Image
- Text

### Search Storage Support
- HydrusNetwork https://github.com/hydrusnetwork/hydrus
- All-Debrid https://alldebrid.com/
- Local drive    

### Search Provider Support
- Youtube 
- Openlibrary/Archive.org (free account needed)
- Soulseek
- Gog-Games (limited without paid API)
- Libgen

### Features
- Full MPV integration https://github.com/mpv-player/mpv 



Install what you need and want, after you have the requirements.txt installed as well you will need to open terminal at the repository download location and run the cli file like .


#### Quick

```shell
cd "C:\location\to\repository\medios-machina\"
python cli.py
```
Adding your first file
```python
.pipe -list  # List MPV current playing/list
.pipe -save  # Save current MPV playlist to local library
.pipe -load  # List saved playlists; use @N to load one
.pipe "https://www.youtube.com/watch?v=_23dFb50Z2Y"  # Add URL to current playlist
```

Example pipelines:

1. **Simple download with metadata (tags and URL registration)**:
```
download-media "https://www.youtube.com/watch?v=dQw4w9WgXcQ" | add-file -storage local | add-url
```

2. **Download playlist item with tags**:
```
download-media "https://www.youtube.com/playlist?list=PLxxxxx" -item 2 | add-file -storage local | add-url
```

3. **Download with merge (e.g., Bandcamp albums)**:
```
download-data "https://altrusiangrace.bandcamp.com/album/ancient-egyptian-legends-full-audiobook" | merge-file | add-file -storage local | add-url
```

4. **Download direct file (PDF, document)**:
```
download-file "https://example.com/file.pdf" | add-file -storage local | add-url
```

Search examples:

1. search-file -provider youtube "something in the way"

2. @1

3. download-media [URL] | add-file -storage local | add-url