Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Added Flatpak guide and some further changes to guides.md #171

Open
wants to merge 5 commits into
base: master
Choose a base branch
from
Open
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
44 changes: 37 additions & 7 deletions md/GLSL_Instructions_Linux.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,27 +4,39 @@

1. Install `mpv` from repositories of your distribution, some of the common ones are mentioned here
### Fedora Silverblue
1. Install the RPM-Fusion "free" repository, if not already installed, paste in the command below
1. Install the RPM-Fusion repository, if not installed already, paste the below command in the terminal

`sudo rpm-ostree install https://mirrors.rpmfusion.org/free/fedora/rpmfusion-free-release-$(rpm -E %fedora).noarch.rpm https://mirrors.rpmfusion.org/nonfree/fedora/rpmfusion-nonfree-release-$(rpm -E %fedora).noarch.rpm`

2. Reboot and install `mpv`

3. Reboot and continue to step 2

### Fedora
### Fedora Workstation/Spins
1. Install the RPM-Fusion repository, if not installed already, paste the below command in the terminal

`sudo dnf install https://mirrors.rpmfusion.org/free/fedora/rpmfusion-free-release-$(rpm -E %fedora).noarch.rpm https://mirrors.rpmfusion.org/nonfree/fedora/rpmfusion-nonfree-release-$(rpm -E %fedora).noarch.rpm`

sudo dnf install mpv

### Ubuntu and Derivatives

- Note: RPM Fusion command for both Fedora Workstation and Fedora Silverblue will add both "free" and "non-free" repository.
To know more about these you can check this [link](https://rpmfusion.org/Configuration)

### Debian/Ubuntu and Derivatives
sudo apt install mpv

- Note: Debian and Ubuntu usually ships with the older version of mpv player in their official repositories. It is advised to check flatpak guide below as it stays upto date with the upstream.

### Arch and Derivatives
sudo pacman -S mpv

### OpenSUSE Tumbleweed

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Do we really need to teach a linux user to use the Package Manager to install a software?

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Do we really need to teach a linux user to use the Package Manager to install a software?

why not, there's already instructions for others package managers for other distro ? what about newbies that rely more on GUI for package manager ? This kind of elitism has no place in a PR comment imo.

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

elitism? It's boring game that taging sb with the strange labels.

sudo zypper install mpv

### Gentoo (Add USE Flags as mentioned [here](https://wiki.gentoo.org/wiki/Mpv#USE_flags))
sudo emerge --ask media-video/mpv`

- Note: make sure to install a version of [**mpv**](https://mpv.io/) that was released after June 2021, older versions [might not work](https://github.com/bloc97/Anime4K/issues/134).
- Note: make sure to install a version of [**mpv**](https://mpv.io/) that was released after June 2021, older versions [might not work](https://github.com/bloc97/Anime4K/issues/134).

2. Clone the repo using `git clone https://github.com/bloc97/Anime4K.git` , or download the archive files in the [Releases](https://github.com/bloc97/Anime4K/releases)

Expand All @@ -38,6 +50,23 @@

5. Create an `input.conf` file in `~/.config/mpv` if not already present and paste one of the following code blocks inside the file:

### Flatpak
Setting up flatpak if not already configured, from [here](https://www.flatpak.org/setup/)

On flatpak mpv, all config files, shaders and scripts have different directories:-

`~/.var/app/io.mpv.Mpv/config/mpv`
`~/.var/app/io.mpv.Mpv/config/mpv/mpv.conf`
`~/.var/app/io.mpv.Mpv/config/mpv/input.conf`
`~/.var/app/io.mpv.Mpv/config/mpv/scripts`
`~/.var/app/io.mpv.Mpv/config/mpv/shaders`

![image](https://user-images.githubusercontent.com/88484339/163166658-38c41daa-f543-43b5-a06c-eddf21bcafb7.png)

Tip:-
Create a `mpv` folder, put all your files and folders(conf, shaders, scripts etc.) in there and copy/paste `mpv` folder to the `~/.var/app/io.mpv.Mpv/config/`
You can also do the same for non-flatpak mpv :-)

----
#### **Optimized shaders for higher-end GPU:**
*(Eg. GTX 1080, RTX 2070, RTX 3060, RX 590, Vega 56, 5700XT, 6600XT)*
Expand Down Expand Up @@ -74,6 +103,7 @@ ____

2. Anime4K v4.x has 3 major modes: A, B and C. To enable one of the modes, press CTRL+1 for mode A, CTRL+2 for B and so on. CTRL+0 will clear and disable all the shaders. Each mode is optimized for a different class of anime degradations, explanations are further down (soon in the wiki). For now you can just try each mode (starting from A) and use the one that looks the best.
3. To verify the installation was correctly done, enable one of the Anime4K modes and use the MPV profiler to check if there are a few shaders with the name Anime4K running. To access the profiler, press Shift+I and then 2 on the keyboard's top row.
This is what you should see (this example is from v2.0RC2, but also applies to newer versions):
![Profiler](../results/MPV_Profiler.png?raw=true)
This is what you should see (this example is from the v4.0.1, but also applies to newer versions):
![image](https://user-images.githubusercontent.com/88484339/163173769-e6e616ec-b465-4f5f-820e-3abe056637b0.png)

4. For advanced usage and more customization options, see the [Advanced Usage Instructions](GLSL_Instructions_Advanced.md) page.