Files
Medios-Macina/readme.md
2025-12-13 12:09:50 -08:00

2.4 KiB

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:

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

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

[store=hydrusnetwork]
NAME="home"
API="..."
URL="http://localhost:45869"

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

File Store

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

cd "C:\location\to\repository\medios-machina\"
python cli.py

Adding your first file

.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
  1. Download playlist item with tags:
download-media "https://www.youtube.com/playlist?list=PLxxxxx" -item 2 | add-file -storage local | add-url
  1. 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
  1. 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