Skip to content

Windows support

Troy Harvey edited this page Jun 7, 2023 · 12 revisions

Windows support.

This documentation is a work in progress.

rmeta is designed for Linux but can run on windows via WSL. Which makes it more complicated but... it is possible.

Setting up WSL:

First you need to install WSL's default distribution Ubuntu. Open command prompt or powershell and run:
wsl --install
Accept any prompts and reboot your system when its finished.

After reboot Ubuntu WSL will launch if it does not, launch it from your start menu. You will need to give Ubuntu WSL a new username and password.

Updating WSL:

Update the Ubuntu WSL package index and update packages. Enter the password you just created when prompted.
sudo apt update
sudo apt upgrade

Installing the dependencies:

Install the required dependencies for downloading and using rmeta.
sudo apt install kid3-cli mkvtoolnix

Installing rmeta:

sudo wget -P /usr/bin https://raw.githubusercontent.com/HarveyDevel/rmeta/master/rmeta
Make sure the file has execute permissions:
sudo chmod +x /usr/bin/rmeta

rmeta is now installed and ready for use.

Navigating WSL:

To access files outside of WSL you will need to navigate to the correct drive and location. Your drives should automatically appear within /mnt/ directory so if your files are in C:\myfiles\ on Windows then to navigate there from WSL you will run.
cd /mnt/c/myfiles

Usage of rmeta:

Please note this script will modify the metadata for ALL files in the active directory.

[command] [argument]
For mkv files:
rmeta mkv

For mp4 files:
rmeta mp4

For both mkv and mp4 files:
rmeta all

You can append -r to any rmeta command to modify files under each directory recursively:
rmeta all -r