Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

3 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Linux Manager Pro

Linux Manager Pro es una aplicación gráfica para Linux desarrollada en Python con PySide6. Su objetivo es centralizar varias tareas comunes de administración del sistema desde una interfaz visual: instalación y desinstalación de aplicaciones, configuración básica de discos, ajustes de rendimiento de CPU y ejecución de comandos administrativos con registro en vivo.

El programa está pensado especialmente para usuarios de distribuciones Linux de escritorio, con foco principal en Arch Linux y derivadas, aunque también incluye compatibilidad parcial para Fedora, Debian y Ubuntu.


Contenido del paquete

El proyecto incluye los siguientes archivos principales:

Linux_Manager_Pro/
├── main.py
├── requirements.txt
├── autorun.sh
└── README.md

main.py

Archivo principal del programa. Contiene toda la lógica de la aplicación gráfica, detección de distribución, listado de aplicaciones, instalación, desinstalación, configuración de discos y control de rendimiento.

requirements.txt

Archivo con las dependencias Python necesarias para ejecutar la aplicación.

Actualmente contiene:

PySide6>=6.6.0

autorun.sh

Script Bash para preparar automáticamente el entorno de ejecución. Crea un entorno virtual Python, instala las dependencias desde requirements.txt y ejecuta el programa.

Comando rápido de ejecución

cd Linux_Manager_Pro
chmod +x autorun.sh
./autorun.sh

README.md

Este documento. Explica el funcionamiento, instalación, ejecución, dependencias, advertencias y estructura general del programa.


Características principales

Linux Manager Pro incluye las siguientes funciones:

  1. Detección automática de la distribución Linux.
  2. Interfaz gráfica moderna basada en PySide6.
  3. Instalación de aplicaciones seleccionadas desde una lista predefinida.
  4. Desinstalación de aplicaciones seleccionadas.
  5. Verificación previa de aplicaciones instaladas.
  6. Marcado visual con check de aplicaciones ya instaladas.
  7. Soporte para paquetes de repositorios oficiales, AUR y Flatpak.
  8. Instalación automática de yay en Arch Linux si no está disponible.
  9. Configuración de OBS VKCapture mediante variable de entorno.
  10. Configuración de CoreCtrl con regla Polkit.
  11. Configuración personalizada de Fastfetch.
  12. Creación de lanzador optimizado para War Robots.
  13. Gestión básica de discos y particiones.
  14. Formateo opcional de unidades en ext4 o btrfs.
  15. Creación de puntos de montaje persistentes en /etc/fstab.
  16. Opción de montaje con noatime.
  17. Opción de permisos amplios sobre el punto de montaje.
  18. Cambio del gobernador de CPU a modo rendimiento o balanceado.
  19. Registro en vivo de los comandos ejecutados.
  20. Barra de progreso de operaciones.
  21. Botón de ayuda integrado.
  22. Sección de autores y disclaimer dentro de la interfaz.

Distribuciones soportadas

El programa detecta la distribución leyendo el archivo:

/etc/os-release

Soporte principal

  • Arch Linux
  • CachyOS
  • EndeavourOS
  • Manjaro

Soporte parcial

  • Fedora
  • Debian
  • Ubuntu
  • Linux Mint

El soporte más completo está orientado a Arch Linux y derivadas porque varias funciones usan pacman, yay, AUR y comandos específicos de ese ecosistema.


Dependencias del sistema

Antes de ejecutar el programa, se recomienda tener instaladas estas herramientas básicas:

En Arch Linux y derivadas

sudo pacman -S --needed python python-pip python-virtualenv git base-devel polkit flatpak

En Fedora

sudo dnf install -y python3 python3-pip python3-virtualenv git polkit flatpak

En Debian/Ubuntu/Linux Mint

sudo apt update
sudo apt install -y python3 python3-pip python3-venv git policykit-1 flatpak

Nota: el script autorun.sh crea un entorno virtual y usa pip dentro de ese entorno. Esto evita el error externally-managed-environment que aparece en distribuciones modernas cuando se intenta instalar paquetes Python directamente en el sistema.


Dependencias Python

La aplicación necesita PySide6 para mostrar la interfaz gráfica.

El archivo requirements.txt contiene:

PySide6>=6.6.0

Si se ejecuta con autorun.sh, esta dependencia se instala automáticamente dentro de .venv.


Cómo ejecutar el programa

Método recomendado usando autorun.sh

Entra a la carpeta del proyecto:

cd Linux_Manager_Pro

Da permisos de ejecución al script:

chmod +x autorun.sh

Ejecuta el programa:

./autorun.sh

El script realizará automáticamente estas acciones:

  1. Verificará que exista python3.
  2. Verificará que exista el archivo main.py.
  3. Creará un entorno virtual en .venv si no existe.
  4. Activará el entorno virtual.
  5. Actualizará pip, setuptools y wheel.
  6. Instalará las dependencias de requirements.txt.
  7. Ejecutará main.py.

Ejecución manual

También puedes ejecutar el programa manualmente.

cd Linux_Manager_Pro
python3 -m venv .venv
source .venv/bin/activate
python -m pip install --upgrade pip setuptools wheel
python -m pip install -r requirements.txt
python main.py

Importante para usuarios de Fish shell

Si usas Fish, no actives el entorno con:

source .venv/bin/activate

En Fish debes usar:

source .venv/bin/activate.fish

Pero si usas autorun.sh, no necesitas activar nada manualmente porque el script se ejecuta con Bash.


Uso de la aplicación

Al iniciar Linux Manager Pro verás una ventana con varias pestañas.


Pestaña Aplicaciones

Esta pestaña permite instalar y desinstalar programas desde una lista predefinida.

La aplicación verifica qué programas ya están instalados y los marca con:

Los programas no detectados aparecen con:

Aplicaciones incluidas

La lista actual incluye, entre otras:

  • Discord
  • Firefox
  • Chromium
  • Microsoft Edge
  • CoreCtrl
  • Fastfetch
  • War Robots Launcher
  • LACT
  • NiriMod
  • OBS Studio
  • OBS VKCapture
  • OBS Cmd
  • Jellyfin Server
  • Bazaar
  • Flatseal
  • Thunderbird
  • Krita
  • GIMP
  • Inkscape
  • Kdenlive
  • VirtualBox

Instalar aplicaciones

  1. Selecciona una o varias aplicaciones.
  2. Presiona el botón Actualizar Sistema e Instalar Seleccionados.
  3. El programa pedirá permisos administrativos mediante pkexec.
  4. La operación se mostrará en la pestaña Proceso en Vivo.

Desinstalar aplicaciones

  1. Selecciona una o varias aplicaciones.
  2. Presiona Desinstalar Seleccionados.
  3. Confirma la operación.
  4. El programa ejecutará los comandos correspondientes según tu distribución.

Pestaña Gestión de Discos

Esta sección permite configurar discos o particiones desde la interfaz.

Funciones disponibles:

  • Listar discos y particiones con lsblk.
  • Seleccionar una unidad.
  • Definir un punto de montaje bajo /mnt/.
  • Formatear opcionalmente en ext4 o btrfs.
  • Crear una entrada persistente en /etc/fstab.
  • Montar la unidad.
  • Aplicar permisos amplios con chmod -R 777 si se selecciona esa opción.

Advertencia importante sobre discos

La opción de formateo borra todos los datos de la unidad seleccionada.

Antes de usar esta función, verifica cuidadosamente:

  • Nombre del dispositivo.
  • Tamaño de la unidad.
  • UUID.
  • Punto de montaje actual.
  • Si contiene datos importantes.

Ejemplo de dispositivo:

/dev/sdb1

No uses esta función si no estás completamente seguro de qué partición estás modificando.


Pestaña Rendimiento

Permite cambiar el gobernador de CPU.

Opciones disponibles:

Modo rendimiento máximo

Configura el gobernador como:

performance

También intenta activar el servicio cpupower para conservar la configuración.

Modo balanceado

Configura el gobernador como:

schedutil

También intenta ajustar el perfil de energía con powerprofilesctl si está disponible.


Pestaña Proceso en Vivo

Muestra la salida de los comandos ejecutados por el programa.

Incluye:

  • Mensajes de instalación.
  • Mensajes de desinstalación.
  • Errores del sistema.
  • Progreso de operaciones.
  • Resultado final.

Esta pestaña es importante para revisar qué ocurrió si alguna operación falla.


Permisos administrativos

Linux Manager Pro usa pkexec para ejecutar acciones que requieren privilegios de administrador.

Esto se usa para tareas como:

  • Instalar paquetes.
  • Desinstalar paquetes.
  • Modificar /etc/fstab.
  • Formatear discos.
  • Montar unidades.
  • Cambiar gobernador de CPU.
  • Crear reglas en /etc/polkit-1/rules.d/.
  • Modificar /etc/environment.

Por seguridad, el sistema puede pedir tu contraseña de administrador.


Arch Linux y AUR

En Arch Linux y derivadas, algunas aplicaciones se instalan desde AUR.

El programa puede intentar instalar yay automáticamente si no está disponible.

Para ello necesita:

git
base-devel

Puedes instalarlos manualmente con:

sudo pacman -S --needed git base-devel

Flatpak y Flathub

Algunas aplicaciones se instalan desde Flatpak.

El programa intenta agregar Flathub automáticamente con:

flatpak remote-add --if-not-exists flathub https://dl.flathub.org/repo/flathub.flatpakrepo

Si Flatpak no está instalado, instálalo antes de ejecutar el programa.

En Arch Linux:

sudo pacman -S flatpak

OBS VKCapture

La opción OBS VKCapture instala el paquete correspondiente y agrega esta variable en /etc/environment:

OBS_VKCAPTURE=1

Esto permite capturar aplicaciones Vulkan con OBS usando VKCapture.

Para que el cambio tenga efecto, puede ser necesario cerrar sesión y volver a entrar, o reiniciar el sistema.


CoreCtrl con regla Polkit

La opción de CoreCtrl crea una regla Polkit para permitir que el usuario activo pueda usar funciones de CoreCtrl sin tener que introducir contraseña constantemente.

La regla se crea en:

/etc/polkit-1/rules.d/90-corectrl.rules

Fastfetch personalizado

La opción Fastfetch instala fastfetch y escribe una configuración en:

~/.config/fastfetch/config.jsonc

La configuración muestra información del sistema como:

  • Sistema operativo.
  • Kernel.
  • Paquetes.
  • Shell.
  • Monitor.
  • Entorno de escritorio.
  • CPU.
  • GPU.
  • Memoria.
  • Swap.
  • Disco.
  • Colores.

War Robots Launcher

La opción War Robots Launcher instala herramientas de rendimiento y crea un script en:

~/iniciar_warrobots.sh

El script usa herramientas como:

  • gamescope
  • gamemode
  • mangohud
  • pactl

La interfaz muestra el parámetro que debes pegar en Steam:

~/iniciar_warrobots.sh %command%

Posibles errores y soluciones

Error: externally-managed-environment

Este error aparece cuando se intenta instalar paquetes Python directamente en el sistema.

Solución recomendada:

./autorun.sh

El script usa un entorno virtual .venv, evitando modificar Python del sistema.


Error: No se encontró python3

Instala Python.

En Arch Linux:

sudo pacman -S python

En Debian/Ubuntu:

sudo apt install python3 python3-venv python3-pip

En Fedora:

sudo dnf install python3 python3-pip

Error: No se abre la ventana gráfica

Verifica que estés dentro de una sesión gráfica y que tengas soporte Qt disponible.

También puedes probar:

source .venv/bin/activate
python main.py

Si estás en Wayland y aparece un problema gráfico, prueba forzar X11:

QT_QPA_PLATFORM=xcb ./autorun.sh

Error con pkexec

Si pkexec no está disponible, instala Polkit.

En Arch Linux:

sudo pacman -S polkit

En Debian/Ubuntu:

sudo apt install policykit-1

En Fedora:

sudo dnf install polkit

Error al instalar desde AUR

Verifica que tengas git y base-devel.

sudo pacman -S --needed git base-devel

También puedes instalar yay manualmente.


Recomendaciones de seguridad

Este programa ejecuta comandos administrativos. Antes de usarlo, se recomienda:

  1. Leer el código fuente.
  2. Revisar las aplicaciones que vas a instalar o desinstalar.
  3. No ejecutar funciones de disco si no estás seguro de la unidad seleccionada.
  4. Hacer copia de seguridad antes de modificar particiones.
  5. Revisar la salida de la pestaña Proceso en Vivo.
  6. No ejecutar el programa como root directamente; deja que use pkexec cuando haga falta.

Advertencia sobre la gestión de discos

La función de formateo puede eliminar información de forma irreversible.

Si seleccionas una partición incorrecta y confirmas el formateo, puedes perder datos importantes.

Los autores no se hacen responsables por pérdida de datos, daños en el sistema, configuraciones incorrectas o uso indebido del programa.


Autores

  • LordBrito
  • LoboViejo79

Disclaimer

Este software se entrega con fines educativos y de administración personal del sistema.

Los creadores no se hacen responsables por daños en el sistema, pérdida de datos, errores de configuración, eliminación accidental de paquetes, formateo incorrecto de discos o cualquier consecuencia derivada del uso de esta herramienta.

Úsalo bajo tu propia responsabilidad.


About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages