![logo](https://code.glowers.club/goyimnose/Medios-Macina/raw/branch/main/docs/img/MM.png)


# Medeia-Macina

Medios-Macina is a CLI media manager and toolkit focused on downloading, tagging, and media storage (audio, video, images, and text) from a variety of providers and sources. It is designed around a compact, pipeable command language ("cmdlets") so complex workflows can be composed simply and repeatably.

## Features
- **Flexible syntax structure:** chain commands with `|` and select options from tables with `@N`.
- **Multiple file stores:** *HYDRUSNETWORK, FOLDER*
- **Provider plugin integration:** *YOUTUBE, OPENLIBRARY, INTERNETARCHIVE, SOULSEEK, LIBGEN, ALLDEBRID, TELEGRAM, BANDCAMP*
- **Module Mixing:** *[Playwright](https://github.com/microsoft/playwright), [yt-dlp](https://github.com/yt-dlp/yt-dlp), [typer](https://github.com/fastapi/typer)*
- **Optional stacks:** Telethon (Telegram), aioslsk (Soulseek), and the FlorenceVision tooling install automatically when you configure the corresponding provider/tool blocks.
- **MPV Manager:** Play audio, video, and even images in a custom designed MPV with trimming, screenshotting, and more built right in! 

## installation ⚡

GIT CLONE https://code.glowers.club/goyimnose/Medios-Macina

1. run python scripts\bootstrap.py  

   - When run interactively (a normal terminal), `bootstrap.py` will show a short menu to Install or Uninstall the project. 

2. rename config.conf.remove to config.conf, [config tutorial](https://code.glowers.club/goyimnose/Medios-Macina/wiki/Config.conf)

### MINIMAL EXAMPLE CONFIG - CHANGE VALUES
```Minimal config
temp="C:\\Users\\Admin\\Downloads"

[store=folder]
name="default"
path="C:\Users\Public\Documents\library"

```

3. Start the CLI by simply running "mm" in shell or run python cli.py

# [CLICK FOR GUIDED TUTORIAL](/docs/tutorial.md)