Pimersus Browser – Manual Installation Guide

Navegador Pimersus: Guía de instalación manual

Pimersus Browser is a lightweight web browser optimized for low-resource and modular Linux environments (Debian, MX Linux, antiX, Linux Lite, Ubuntu-based systems).

Pimersus Browser es un navegador web liviano optimizado para entornos Linux modulares y de bajos recursos (Debian, MX Linux, antiX, Linux Lite, sistemas basados en Ubuntu).

If the .deb package fails to install due to missing dependencies or incompatible libraries, you can perform a manual installation using the instructions below.

Si el paquete .deb no se puede instalar debido a dependencias faltantes o bibliotecas incompatibles, puede realizar una instalación manual siguiendo las instrucciones a continuación.

---

🔧 1. Install Required Dependencies

🔧 1. Instalar las dependencias necesarias

Pimersus Browser requires GTK, WebKitGTK and GStreamer libraries. El navegador Pimersus requiere las bibliotecas GTK, WebKitGTK y GStreamer.

sudo apt update
sudo apt install libgtk-3-0 libwebkit2gtk-4.0-37 gstreamer1.0-plugins-base \
                 gstreamer1.0-plugins-good gstreamer1.0-plugins-bad \
                 gstreamer1.0-plugins-ugly gstreamer1.0-libav \
                 gstreamer1.0-pulseaudio libavcodec-extra

⚠️ Important

The libwebkit2gtk package version varies by distribution.

La versión del paquete libwebkit2gtk varía según la distribución.

If you get an error like “libwebkit2gtk-4.0-37 not found”, try:

Si recibe un error como “libwebkit2gtk-4.0-37 no encontrado”, intente:

sudo apt install libwebkit2gtk-4.1-0

Or search manually:

O buscar manualmente:

apt search webkit2gtk

Linux Lite, in particular, often uses more recent Ubuntu WebKitGTK libraries.

Linux Lite, en particular, a menudo utiliza bibliotecas Ubuntu WebKitGTK más recientes.

It has not been tested, but in theory it could work on Debian 13, with the following libraries. No se ha probado, pero en teoría podría funcionar en Debian 13, con las siguientes bibliotecas.

sudo apt update
sudo apt install libgtk-3-0 libwebkit2gtk-4.1-0 \
    gstreamer1.0-plugins-base gstreamer1.0-plugins-good \
    gstreamer1.0-plugins-bad gstreamer1.0-plugins-ugly \
    gstreamer1.0-libav gstreamer1.0-pulseaudio libavcodec-extra

Currently, my backup distro (PimersusOS) is based on Debian 12, so in theory, with the previous libraries, it should work on Debian 13. Actualmente, mi distribución de respaldo (PimersusOS) está basada en Debian 12, por lo que en teoría, con las bibliotecas anteriores, debería funcionar en Debian 13.

---

📂 2. Copy the Binary

📂 2. Copiar el binario

If you compiled or downloaded the pimersus-browser binary, copy it to /usr/local/bin: Remember, the binary file is in a folder, whether it's your downloads folder or any other folder where you download files.

Si compilaste o descargaste el binario pimersus-browser, cópialo a /usr/local/bin: Recuerda que el archivo binario está en una carpeta, ya sea tu carpeta de descargas o cualquier otra carpeta donde descargues archivos.

sudo cp /path/to/your/downloaded/pimersus-browser /usr/local/bin/pimersus-browser
sudo chmod +x /usr/local/bin/pimersus-browser

If it's in your Downloads folder:

Si está en tu carpeta de Descargas:

sudo cp ~/your/folder/for-downloads/pimersus-browser /usr/local/bin/pimersus-browser
sudo chmod +x /usr/local/bin/pimersus-browser

---

🚀 3. Create the Launcher Script

🚀 3. Crear el script del lanzador

sudo nano /usr/local/bin/pimersus-browser-launcher

Paste:

Pegar:

#!/bin/bash
# Official launcher for Pimersus Browser
GDK_GL=disable /usr/local/bin/pimersus-browser "$@"

Save: Ctrl+o / Enter / Ctrl+x

Guardar: Ctrl+o / Enter / Ctrl+x

Make it executable:

Hazlo ejecutable:

sudo chmod +x /usr/local/bin/pimersus-browser-launcher

---

🖼️ 4. Desktop Integration

🖼️ 4. Integración de escritorio

Create a .desktop file:

Crea un archivo .desktop:

sudo nano /usr/share/applications/pimersus-browser.desktop

Insert:

Insertar:

[Desktop Entry]
Name=Pimersus Browser
Exec=pimersus-browser-launcher
Icon=pimersus
Type=Application
Categories=Network;WebBrowser;
Comment=Lightweight web browser for Pimersus OS

Save: Ctrl+o / Enter / Ctrl+x

Guardar: Ctrl+o / Enter / Ctrl+x

---

🎨 5. Icons

🎨 5. Iconos

Copy your icon here:

Copia tu icono aquí:

/usr/share/icons/hicolor/48x48/apps/pimersus.png

If you don't know how to copy: sudo cp /folder/downloads/pimersus.png /usr/share/icons/hicolor/48x48/apps/pimersus.png

Sino sabes como copiar: sudo cp /carpeta/descargas/pimersus.png /usr/share/icons/hicolor/48x48/apps/pimersus.png

Update icon and desktop caches:

Actualizar los cachés de iconos y escritorios:

sudo gtk-update-icon-cache /usr/share/icons/hicolor
sudo update-desktop-database

---

🚀 6. Launching the Browser

🚀 6. Iniciar el navegador

You can now start Pimersus Browser:

Ya puedes iniciar Pimersus Browser:

• From your Application Menu, under Internet / Web Browser
• Or from terminal:

Desde el Menú de Aplicaciones, en Internet / Navegador web O desde la terminal:

pimersus-browser-launcher

---

📝 Notes & Troubleshooting

📝 Notas y solución de problemas

✔ If installation fails

✔ Si la instalación falla

sudo apt -f install

✔ Missing libraries

✔ Bibliotecas faltantes

ldd /usr/local/bin/pimersus-browser

✔ Linux Lite Specifics

✔ Especificaciones de Linux Lite

sudo apt install libwebkit2gtk-4.1-0 libjavascriptcoregtk-4.1-0

✔ Permissions issues

✔ Problemas de permisos

chmod +x /usr/local/bin/pimersus-browser