Medios-Macina/readme.md

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

### Configuration

The default config format is `config.conf`.

- Required: `temp` (where temporary/intermediate files are written)
- Optional: any number of stores and provider credentials
- Modular: you can add extra `.conf` fragments in `config.d\*.conf` (they will be merged)

Example `config.conf`:

```ini
temp="C:\\Users\\Admin\\Downloads"

[store=folder]
name="default"
path="C:\\Media Machina"

[store=hydrusnetwork]
name="home"
Hydrus-Client-API-Access-Key="..."
url="http://localhost:45869"

[provider=OpenLibrary]
email="user@example.com"
password="..."
```

### File Store
- HydrusNetwork https://github.com/hydrusnetwork/hydrus
- Local drive (C://mylibrary/path)   

### File Providers
- Youtube
- Openlibrary/Archive.org (free account needed)
- Soulseek
- Gog-Games (limited without paid API)
- Libgen
- All-Debrid https://alldebrid.com/

### Features
- Full MPV integration https://github.com/mpv-player/mpv 
- Database file management
- API/CLI exclusive 
- Plug and play stores and add-ons
- YT-DLP integration
- CMDLET easy syntax
- CLI auto-complete

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