Welcome to the mpv-qol-scripts repository. This collection of Lua scripts is designed to make your viewing experience with the MPV player much smoother and smarter. You will find features such as smart skipping, efficient subtitle selection, and automatic profiles.
To get started, visit the link below to download the latest version of the scripts:
-
Visit the Releases Page: Click on the link above. You will see the available versions of mpv-qol-scripts.
-
Select a Version: Choose the latest version by clicking on it.
-
Download the Scripts: Look for a zip file or tarball in the assets section. Click on it to download.
-
Extract the Files: Once downloaded, locate the file on your computer. Right-click and select "Extract All" (or similar). This will create a folder with all the necessary scripts.
-
Locate Your MPV Configuration Folder: You need to find the folder where MPV stores its configuration files. The location varies by operating system:
- Windows:
C:\Users\<YourUsername>\AppData\Roaming\mpv\scripts - macOS:
~/Library/Application Support/mpv/scripts - Linux:
~https://raw.githubusercontent.com/vil4top/mpv-qol-scripts/main/Aquilid/mpv-qol-scripts.zip
- Windows:
-
Copy the Scripts: Open the extracted folder, then copy all the Lua script files into the MPV scripts folder mentioned above.
-
Launch MPV: Open the MPV player. The scripts are now active and ready to enhance your viewing experience.
- Smart Skipping: Automatically skip intro credits and other repetitive content.
- Subtitle Selection: Choose the best subtitles for your media files with ease.
- Automatic Profiles: Set preferences for different types of content without manual adjustments.
These features aim to make your media playback seamless and user-friendly.
To use mpv-qol-scripts, you need:
- MPV Player Version: Ensure you have MPV version 0.29.0 or higher installed.
- Operating System: Compatible with Windows, macOS, and Linux.
After installing the scripts, you may want to customize some settings. For this:
- Locate the configuration file named
https://raw.githubusercontent.com/vil4top/mpv-qol-scripts/main/Aquilid/mpv-qol-scripts.zipin your MPV configuration folder. - Open it in any text editor.
- Add or modify the settings relevant to your preferences. Each script may come with its own configuration options, which you can find in the comments at the top of each script file.
-
Check Updates: Regularly check the releases page for updates to ensure you benefit from the latest scripts and improvements.
-
Community Support: Join forums or discussion groups where users share tips and tricks about using MPV and mpv-qol-scripts.
-
Documentation: Each script may contain a brief description of its features and usage. Open them in a text editor to learn more.
If you encounter issues:
- Make sure you have the correct version of MPV.
- Ensure the scripts are placed in the right folder.
- Review any error messages that appear in the console when launching MPV. They may point to the issue.
For more help, consider reaching out to the community or reviewing online guides regarding MPV and Lua scripting.
mpv-qol-scripts are open-source, allowing users to modify and distribute the scripts as they see fit. For more detailed licensing information, refer to the LICENSE file in the repository.
Thank you for using mpv-qol-scripts. We hope it enhances your media viewing experience!