Govibe Nexus Video Player
Installation Guide for Linux
Version 1.0.59

Thank you for installing Govibe Nexus Video Player.

Govibe Nexus Video Player is a free Linux media player built with an mpv powered playback engine. It can play video and audio files in a clean Nexus style interface. It includes equalizer presets, video filters, fullscreen mode, volume control, volume boost, a separate playlist window, and an audio spectrum visual effect for music files.

This version includes an updated mpv embedded video opening path for better stability when opening video files.

Supported packages:

DEB package:
For Debian, Ubuntu, Linux Mint, Pop OS, Zorin OS, and other Debian or Ubuntu based systems.

RPM package:
For Fedora, Red Hat, CentOS, Rocky Linux, AlmaLinux, and other RPM based systems.


============================================================
1. Before you install
============================================================

Make sure the file you downloaded matches your Linux system.

For Ubuntu, Debian, Linux Mint, Pop OS, or Zorin OS:
Use the .deb file.

For Fedora, Red Hat, CentOS, Rocky Linux, or AlmaLinux:
Use the .rpm file.

Recommended dependency:
mpv

Optional recommended dependency:
ffmpeg

mpv is used for media playback.
ffmpeg can help with audio rhythm reading for the spectrum effect when available.

The installer may install or request required dependencies automatically depending on your system.


============================================================
2. Important update note
============================================================

If you already installed an older version, remove the old version first.

Ubuntu or Debian:

sudo apt remove govibe-nexus-video-player
sudo apt autoremove

Fedora, Red Hat, CentOS, Rocky Linux, or AlmaLinux:

sudo dnf remove govibe-nexus-video-player

For older CentOS systems:

sudo yum remove govibe-nexus-video-player

After removing the old version, install the new package using the instructions below.


============================================================
3. Install on Ubuntu or Debian
============================================================

Open Terminal in the folder where the .deb file is located.

Example command:

sudo apt install ./GovibeNexusVideoPlayer_v1.0.59_DEBIAN_UBUNTU.deb

Enter your password when asked.

After installation, open Govibe Nexus Video Player from your application menu.


Alternative install method on Ubuntu
============================================================

You can also double click the .deb file and install it with the Software Center if your system supports it.


Fix missing dependencies on Ubuntu or Debian
============================================================

If the installation says some dependencies are missing, run:

sudo apt --fix-broken install

Then try opening the player again.


============================================================
4. Install on Fedora
============================================================

Open Terminal in the folder where the .rpm file is located.

Example command:

sudo dnf install ./GovibeNexusVideoPlayer-v1.0.59-1.noarch.rpm

Enter your password when asked.

After installation, open Govibe Nexus Video Player from your application menu.


============================================================
5. Install on Red Hat, CentOS, Rocky Linux, or AlmaLinux
============================================================

Open Terminal in the folder where the .rpm file is located.

For newer systems, use:

sudo dnf install ./GovibeNexusVideoPlayer-v1.0.59-1.noarch.rpm

For older CentOS systems, use:

sudo yum localinstall ./GovibeNexusVideoPlayer-v1.0.59-1.noarch.rpm

After installation, open Govibe Nexus Video Player from your application menu.


============================================================
6. Install mpv manually if needed
============================================================

Govibe Nexus Video Player uses mpv for playback.

Ubuntu or Debian:

sudo apt update
sudo apt install mpv

Fedora:

sudo dnf install mpv

Red Hat, CentOS, Rocky Linux, or AlmaLinux:

sudo dnf install mpv

If mpv is not available on your RPM based system, enable your normal multimedia repository for your distribution, then install mpv again.


============================================================
7. Install ffmpeg manually if needed
============================================================

ffmpeg is optional. The player can run without it, but installing ffmpeg can improve audio rhythm detection for the spectrum effect.

Ubuntu or Debian:

sudo apt install ffmpeg

Fedora:

sudo dnf install ffmpeg

Red Hat, CentOS, Rocky Linux, or AlmaLinux:

sudo dnf install ffmpeg

If ffmpeg is not available on your RPM based system, enable your normal multimedia repository for your distribution, then install ffmpeg again.


============================================================
8. Update to a newer version
============================================================

The safest way to update is to remove the old version first, then install the new version.

Ubuntu or Debian:

sudo apt remove govibe-nexus-video-player
sudo apt install ./GovibeNexusVideoPlayer_v1.0.59_DEBIAN_UBUNTU.deb

Fedora, Red Hat, CentOS, Rocky Linux, or AlmaLinux:

sudo dnf remove govibe-nexus-video-player
sudo dnf install ./GovibeNexusVideoPlayer-v1.0.59-1.noarch.rpm


============================================================
9. Uninstall from Ubuntu or Debian
============================================================

To remove Govibe Nexus Video Player:

sudo apt remove govibe-nexus-video-player

Optional cleanup:

sudo apt autoremove


============================================================
10. Uninstall from Fedora, Red Hat, CentOS, Rocky Linux, or AlmaLinux
============================================================

To remove Govibe Nexus Video Player:

sudo dnf remove govibe-nexus-video-player

For older CentOS systems:

sudo yum remove govibe-nexus-video-player


============================================================
11. How to use
============================================================

1. Open Govibe Nexus Video Player.
2. Click OPEN VIDEO OR AUDIO.
3. Choose a video or audio file.
4. Use PLAY, PAUSE, STOP, MUTE, LOOP, FULL, and FOCUS VIDEO as needed.
5. Use the volume bar for normal volume.
6. Use BOOST VOLUME for stronger sound when needed.
7. Use the right side controls for colour adjustment, volume boost, equalizer presets, and video filters.
8. Right click inside the player for extra options.
9. Use the playlist option to open the separate playlist window.


============================================================
12. Playlist
============================================================

Govibe Nexus Video Player includes a separate playlist window.

You can:

Open or close the playlist from the right side button.
Open the playlist from the right click menu.
Drag and drop files into the playlist.
Select multiple files.
Use Ctrl or Shift selection.
Drag over playlist rows to select multiple items.
Double click a playlist item to play it.
Remove selected items.
Clear the playlist.


============================================================
13. Audio playback and spectrum effect
============================================================

Audio files open in audio mode.

When an audio file is opened, the player can show a spectrum style visual effect in the video area. The spectrum is designed to fit the Nexus theme and react to the audio rhythm when rhythm data is available.

Supported audio examples:

MP3, WAV, FLAC, OGG, OPUS, M4A, AAC, WMA, AIFF, ALAC, APE, WV, AMR, AC3, DTS, and MIDI.


============================================================
14. Video playback
============================================================

Video files open in normal video mode using the embedded mpv playback engine.

This version improves how mpv is embedded inside the player window, making video opening more stable.

Supported video examples:

MP4, MKV, WEBM, MOV, AVI, M4V, MPG, MPEG, WMV, FLV, and other formats supported by mpv.


============================================================
15. Set as default player
============================================================

The right click menu includes default player options.

You can set Govibe Nexus Video Player as the default video player.
You can set Govibe Nexus Video Player as the default audio player.

Depending on your Linux desktop, you may also need to confirm the default application from your system settings.


============================================================
16. First launch note
============================================================

On some Linux systems, the first launch after a reboot can take a few seconds while the media engine starts.

If a file does not open right away:

1. Wait a few seconds.
2. Try opening the file again.
3. Make sure mpv is installed.


============================================================
17. Troubleshooting
============================================================

The player does not open:

Run this command to check mpv:

mpv --version

The video does not play:

Try installing mpv manually using the commands above.
Try removing the old package and installing the newest package again.

The player closes when opening a video:

1. Remove the old version.
2. Install the newest package.
3. Make sure mpv is installed.
4. Try opening the video again.

Ubuntu or Debian:

sudo apt remove govibe-nexus-video-player
sudo apt install ./GovibeNexusVideoPlayer_v1.0.59_DEBIAN_UBUNTU.deb

Fedora, Red Hat, CentOS, Rocky Linux, or AlmaLinux:

sudo dnf remove govibe-nexus-video-player
sudo dnf install ./GovibeNexusVideoPlayer-v1.0.59-1.noarch.rpm

The audio spectrum does not react much:

Install ffmpeg if it is not installed.
Try another audio file.
Some files may provide stronger rhythm movement than others.

The package does not install:

Make sure you are using the correct file type for your system.

Ubuntu and Debian use .deb
Fedora, Red Hat, CentOS, Rocky Linux, and AlmaLinux use .rpm

The app still has an old version:

Uninstall the old version first, then install the new package.


============================================================
18. License note
============================================================

Govibe Nexus Video Player is free software to use.

It is not open source unless a separate source code release is provided by Govibe.


============================================================
19. Website
============================================================

Govibe:
https://govibe.org
