Files
Medios-Macina/docs/tutorial.md
nose 2542a68479
Some checks failed
smoke-mm / Install & smoke test mm --help (push) Has been cancelled
jhj
2025-12-24 23:31:05 -08:00

3.4 KiB

set up config.conf

the config file is meant to be modular, you only need to put in what you want. technically you do not need a file store, but you will miss out on a bunch features. For this tutorial we are going to make an example folderstore. Add the below to your config.conf, pick a path for you that is a blank folder non-system folder.

config.conf
[store=folder]
name="tutorial"
path="C:\Users\Admin\Downloads\tutorial"

after your done save the file and restart the cli.py

Downloading from youtube

cookies.txt required - cookies.txt guide

start up the cli and enter this at prompt, you can copy and paste

<🜂🜄|🜁🜃>
download-media "https://www.youtube.com/watch?v=_23dFb50Z2Y" | add-file -store tutorial

Available formats this shows the available formats you can download, the audio is audio only, and the video will automatically merge audio so you only need to pick the video if you want video and audio. it is ordered best quality at the lowest/highest number down.

the # column is how you select what you want to pick, run this next

<🜂🜄|🜁🜃>
@8 

add-file

files inside of stores are renamed as their hash, you will only be able to find your file by searching for it, the title: tag acts as a psuedo filename, if you search "terry" then the file will be brought up, if you search "archeroflusitania" the file will not come up, you need to prepend the namespace first, "channel:archeroflusitania"; you can also use wild card "channel:arch*" and that will pull it up. lets see what tags the file has, run this.

<🜂🜄|🜁🜃>
@1 | get-tag 

get-tag these tags are scraped from the youtube video using yt-dlp, they are stored in your store's database, this is how you will actually find your files so make sure it has either a title: tag that you can look up or you add your custom tags now lets add more tags, run this

<🜂🜄|🜁🜃>
@ | add-tag "cli,ubuntu,desktop"

add-tag

we added freeform tags, freeform tags are tags that dont have colons in them, these tags show up in searches without any special prepends. run the following below to search for our new tags added to the file.

<🜂🜄|🜁🜃>
search-store "ubuntu"

search-store

to access your file and view it, you can run either

@1 | get-file

or if you have mpv installed (the preferred way for video files)

(Tip: the bootstrap/setup scripts will try to install mpv for you if it's not found on PATH. If it isn't available, install mpv manually and ensure mpv is on your PATH.)

@1 | .pipe

Bandcamp downloading (provider method)

<🜂🜄|🜁🜃>
search-provider -provider bandcamp "artist:altrusian grace media"