Medios-Macina/readme.md

<div align="center">
<h1>MEDEIA-MACINA</h1>
<img src="https://code.glowers.club/goyimnose/Medios-Macina/raw/branch/main/docs/img/MM.png"></img>
<h3>4 TEXT BASED FILE ONTOLOGY </h3>
</div>

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.

<hr>
<h2>CONTENTS</H2>
<a href="#features">FEATURES</a><br>
<a href="#installation">INSTALLATION</a>





<div id="features"><h2> Features</h2>
<ul>
<li><b>Flexible syntax structure:</b> chain commands with `|` and select options from tables with `@N`.</li>

<li><b>Multiple file stores:</b> *HYDRUSNETWORK, FOLDER*
- **Provider plugin integration:** *YOUTUBE, OPENLIBRARY, INTERNETARCHIVE, SOULSEEK, LIBGEN, ALLDEBRID, TELEGRAM, BANDCAMP*</li>
<li><b>Module Mixing:</b> *[Playwright](https://github.com/microsoft/playwright), [yt-dlp](https://github.com/yt-dlp/yt-dlp), [typer](https://github.com/fastapi/typer)*</li>
<li><b>Optional stacks:</b> Telethon (Telegram), aioslsk (Soulseek), and the FlorenceVision tooling install automatically when you configure the corresponding provider/tool blocks.
<li><b>MPV Manager:</b> Play audio, video, and even images in a custom designed MPV with trimming, screenshotting, and more built right in!</li>
</ul

</div>
<div id="installation"><h2> INSTALLATION</h2>
 <h4><b>Requirement:</b> <a href="https://www.python.org/downloads/">Python</a>
<br>

<details>
<summary>console command</summary>

<pre><code>
git clone https://code.glowers.club/j/Medios-Macina
python Medios-Macina/scripts/bootstrap.py
</code></pre>

</details>




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

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

</div>
### 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)