Saltar al contenido

cuaderno de campo

anotaciones

Menú
  • casa
    • dinou del carrer nou
  • cocina
    • pan
    • repostería
    • verdura
  • huerto
    • instrucciones sobre el huerto
    • plano del número 29
    • huerto del año 2025
  • humanidades
    • fonoteca
    • galería
  • juego
    • colección de roms
    • steamos en steam deck
    • lista de juego
    • dosbox
  • linux
    • bash
    • sistema operativo
    • ssh
  • web
    • apache
    • css
    • html5
    • javascript
    • mysql
    • php
Menú

steamos en steam deck

Publicada el 18 de septiembre de 202312 de agosto de 2025 por ernesto
  • instalación
    • instalación de raspberry pi imager
    • instalación de steamos
  • configuración
    • modo escritorio
      • acceso a un terminal
      • cambio de contraseña
      • servidor ssh
      • cambio de idioma
      • teclado
    • modo juego
      • teclado
  • juegos
    • instalación de juegos que no son de steam
      • desde ubuntu
      • desde steamos
    • instalación de juegos de DOS
      • instalación de DOSBox
      • instalación de Flatseal
      • lanzador de DOSBox para Steam
      • dosbox-0.74-3.conf
    • compatibilidad con steam
    • parámetros de lanzamiento
      • pantalla completa ó fullscreen
      • depuración ó condebug
    • ajustes del mando
      • modo ratón
    • ilustración y fondo personalizado
      • modificación manual
      • vía steamgriddb
  • atajos
    • capturas de pantalla ó screenshots
      • modo escritorio
  • problemario
    • wifi inestable
    • SMPTE color bars ó carta de ajuste en lugar de videos
  • fuentes
    • Artículos y videos
    • Steam
Puesto al día el 12 de agosto de 2025.
SteamOS

SteamOS is a public release of our Linux-based operating system. The base system draws from Debian 8, code named Debian Jessie. Our work builds on top of the solid Debian core and optimizes it for a living room experience. Most of all, it is an open Linux platform that leaves you in full control. You can take charge of your system and install new software or content as you want.

«So, what is SteamOS?» en SteamOS de Steam.

instalación

en primer lugar, hay que descargar la imagen de recuperación de la Steam Deck: a 18 de setiembre de 2023, se trata del archivo steamdeck-recovery-4.img.bz2 de 2,7 GB.

instalación de raspberry pi imager

sudo snap install rpi-imager

rpi-imager

instalación de steamos

una vez abierta la aplicación Raspberry Pi Imager, basta con seleccionar el archivo de imagen de recuperación de la Steam Deck y el lápiz USB ó tarjeta SD de destino (con una capacidad mínima de 8 GB):

Operating System > Choose OS > Use custom > steamdeck-recovery-4.img.bz2

concluida la operación de write, ya se puede conectar el lápiz USB ó tarjeta SD a la Steam Deck mediante un adaptador USB-C. hecho esto, debe iniciarse el administrador de arranque de la máquina para lanzar la imagen instalada en la memoria USB:

  1. Se apaga la Steam Deck.
  2. Se mantienen pulsados el botón de bajar el volumen (-) y el botón de inicio hasta que el dispositivo emita un pitido.
  3. Tras el pitido, se suelta el botón de volumen (-) y la Steam Deck carga el administrador de arranque.
  4. Una vez dentro del administrador, hay que lanzar la imagen de recuperación de SteamOS desde el «EFI USB Device» (la memoria USB).
  5. Esta operación tarda unos segundos (la pantalla, mientras tanto, permanece a oscuras).
  6. Finalmente, aparece el escritorio del entorno de recuperación.

en el entorno de recuperación, hay que elegir la opción «reinstalar SteamOS» para volver a instalar el sistema operativo en la Steam Deck o «recrear la imagen de Steam Deck» si se ha cambiado la SSD (y están por crear las particiones).

configuración

modo escritorio

STEAM (botón) > Iniciar/Apagar > Cambiar a Escritorio

acceso a un terminal

Inicio > System > Konsole

si no se dispone de un teclado físico, se puede acceder al teclado virtual con el botón X (B para quitarlo).

cambio de contraseña

passwd

New password:
Retype new password:
passwd: password updated successfully

servidor ssh

en este ejemplo, la Steam Deck dispone de la dirección IP 192.168.1.8 y su cliente, de la 192.168.1.7. en la versión holo de SteamOs (v3.4.10), el servidor ssh ya está instalado de base (aunque no habilitado ó enabled).

sudo nano /etc/hostname

SD

sudo nano /etc/hosts

192.168.1.8 SD

sudo nano /etc/hosts.allow

ALL:192.168.1.7

sudo nano /etc/hosts.deny

ALL:ALL

sudo nano /etc/ssh/sshd_config

Port 9876
LoginGraceTime 15
PermitRootLogin no
AuthorizedKeysFile .ssh/authorized_keys
PasswordAuthentication no

sudo systemctl enable sshd.service

Created symlink /etc/systemd/system/multi-user.target.wants/sshd.service → /usr/lib/systemd/system/sshd.service.

sudo systemctl start sshd.service

sudo systemctl status sshd.service

● sshd.service - OpenSSH Daemon
Loaded: loaded (/usr/lib/systemd/system/sshd.service; enabled; preset: disabled)
Active: active (running) since Fri 2023-09-29 21:15:46 CEST; 43min ago
[...]
Sep 29 21:15:46 SD sshd[920]: Server listening on :: port 9876.

las instrucciones completas para configurar el servicio ssh se encuentran en ssh: configuracion servidor-cliente (así como el método de identificación mediante claves ssh).

cambio de idioma

antes de proceder con los cambios, hay que permitir la escritura en el sistema operativo mediante steamos-readonly. luego, se modifican los archivos /etc/locale.gen y /etc/locale.conf según se indica a continuación y se vuelve a generar la configuración regional ó locale vía locale-gen:

sudo steamos-readonly disable

sudo steamos-readonly status

disabled

sudo nano /etc/locale.gen

es_ES.UTF-8

sudo nano /etc/locale.conf

LANG=en_US.UTF-8
LANG=es_ES.UTF-8

sudo locale-gen

Generating locales…
en_US.UTF-8… done
es_ES.UTF-8… done
Generation complete.

locale

LANG=es_ES.UTF-8
[...]

teclado

una vez se ha modificado el idioma, se puede cambiar la distribución del teclado desde las preferencias del sistema:

Inicio > Preferencias > Preferencias del sistema > Hardware > Dispositivos de entrada > Teclado > Distribuciones > +Añadir > Catalán (España con L con punto medio) > Subir > Aplicar

Inicio > Preferencias > Preferencias regionales > Idioma > Modificar > Añadir más > español de España > Aplicar

que sepa, este cambio sólo se aplica en el modo de escritorio.

modo juego

teclado

este cambio afecta a la distribución del teclado en el modo de juego:

sudo nano /etc/environment

XKB_DEFAULT_LAYOUT=es

juegos

instalación de juegos que no son de steam

desde ubuntu

valga como ejemplo la instalación del remake del Sir Fred de 2005 de Daniel Celemín: el archivo zip (9,1MB) se puede descargar gratuitamente desde Computer Emuzone.

unzip SirFred.zip

Archive: SirFred.zip
inflating: computeremuzone.com.htm
inflating: SirFred.exe

proton-call -r SirFred.exe

Running Proton 6.3 for SirFred.exe
fsync: up and running.
wine: RLIMIT_NICE is <= 20, unable to use setpriority safely
[...]

las instrucciones para instalar proton-call en ubuntu pueden seguirse paso a paso en steam + proton en ubuntu.

dicho esto, una vez instalado el juego en ubuntu, en la ruta Z:\home\ernesto\tmp\Sir Fred el Remake, es momento de transferir los archivos a la Steam Deck vía rsync:

rsync -avzP -e "ssh -p 9876" /home/ernesto/tmp/Sir Fred el Remake/ deck@192.168.1.8:/home/deck/archivo/sir_fred/

desde steamos

una vez copiados los archivos del Sir Fred a la Steam Deck, se añade el juego a la aplicación de Steam desde el modo escritorio:

Añadir un producto que no es de Steam...
Añadir un producto que no es de Steam...

la opción se despliega desde Añadir un producto, en la esquina inferior izquierda de la aplicación: en la ventana Añadir un producto que no es de Steam, hay que seleccionar el ejecutable SirFred.exe que se encuentra en /home/deck/archivo/sir_fred/.

Añadir un producto > Añadir un producto que no es de Steam... > Buscar... > Home > archivo > sir_fred > SirFred.exe > Open > Añadir seleccionado

hecho esto, el juego ya se ha incorporado a la biblioteca de Steam.

instalación de juegos de DOS

los juegos de DOS se ejecutan en SteamOS gracias al emulador DOSBox o, si se prefiere, DOSBox Pure.

instalación de DOSBox

la instalación de DOSBox en la Steam Deck se realiza desde el modo escritorio:

Inicio > System > Discover > Search… > dosbox > DOSBox > Install

Discover > DOSBox
Discover > DOSBox

hay que tener en cuenta que la instalación de DOSBox vía flatpak (es decir, a través de Discover) limita el acceso de la aplicación a los archivos de un único directorio: /home/deck/Documents. no obstante, si se quiere acceder a cualquier otro directorio, se pueden modificar los permisos de DOSBox con Flatseal.

instalación de Flatseal

la instalación de Flatseal en la Steam Deck también se realiza desde el modo escritorio:

Inicio > System > Discover > Search… > flat > Flatseal > Install

Discover > Flatseal
Discover > Flatseal

según se lee en Discover, «Flatseal es una utilidad gráfica para revisar y modificar permisos básicos de sus aplicaciones Flatpak». luego, si se instalan los archivos de DOS fuera de la carpeta de documentos, habrá que recurrir a Flatseal para otorgarle permisos de acceso a DOSBox donde fuera necesario:

Flatseal > DOSBox > Filesystem > Otros archivos
Flatseal > DOSBox > Filesystem > Otros archivos

en este caso, se ha añadido el directorio /home/deck/archivo/dos a la lista de archivos disponibles para la aplicación DOSBox.

lanzador de DOSBox para Steam

la instalación de DOSBox vía flatpak supone que DOSBox se lanza desde flatpak:

flatpak run com.dosbox.DOSBox -version

DOSBox version 0.74-3, copyright 2002-2019 DOSBox Team.

DOSBox is written by the DOSBox Team (See AUTHORS file))
DOSBox comes with ABSOLUTELY NO WARRANTY. This is free software, and you are welcome to redistribute it under certain conditions; please read the COPYING file thoroughly before doing so.

de este modo, flatpak es la aplicación a la que debe llamarse en el acceso directo de Steam, sin más: /usr/bin/flatpak. el resto del comando de ejecución, run com.dosbox.DOSBox, se expresa en los parámetros de lanzamiento y, a continuación, en la misma sentencia, se declaran las órdenes propias de DOSBox: en este punto, se puede cargar un archivo ejecutable de DOS (con extensión EXE, COM ó BAT) o, mediante -conf, un archivo de configuración propio que se ocupa de lanzar un ejecutable desde la sección autoexec:

nano /home/deck/archivo/dos/prince_of_persia/prince.conf

[autoexec]
# echo "PRINCE OF PERSIA"
mount C /home/deck/archivo/dos/
C:
cd prince~1
PRINCE.EXE

Prince of Persia > Acceso directo
Prince of Persia > Acceso directo
  • Destino: /usr/bin/flatpak
  • Iniciar en /home/deck/archivo/dos
  • Parámetros de lanzamiento: run com.dosbox.DOSBox -conf /home/deck/archivo/dos/prince_of_persia/prince.conf
dosbox-0.74-3.conf

el archivo de configuración original de DOSBox, dosbox-0.74-3.conf, ofrece una descripción de todas las opciones disponibles (además de una configuración determinada):

find ~ -iname dosbox*.conf

/home/deck/.var/app/com.dosbox.DOSBox/.dosbox/dosbox-0.74-3.conf

nano /home/deck/.var/app/com.dosbox.DOSBox/.dosbox/dosbox-0.74-3.conf

# This is the configuration file for DOSBox 0.74-3. (Please use the latest version of DOSBox)
# Lines starting with a # are comment lines and are ignored by DOSBox.
# They are used to (briefly) document the effect of each option.
[...]

compatibilidad con steam

la compatibilidad con Steam se activa desde el menú de propiedades del juego y, a las propiedades del juego, se accede desplegando el menú de contexto con L2 sobre la carátula del juego o con el icono de configuración del juego:

Propiedades... > Compatibilidad > Forzar el uso de una herramienta especifica de compatibilidad para Steam Play > Proton 8.0-3

Compatibilidad

parámetros de lanzamiento

pantalla completa ó fullscreen

la pantalla completa se fuerza con el parámetro de lanzamiento fullscreen en la propia ventana del acceso directo:

Acceso directo > Parámetros de lanzamiento
Acceso directo > Parámetros de lanzamiento
depuración ó condebug

el parámetro de lanzamiento condebug permite registrar las operaciones que se dan, por ejemplo, durante la ejecución de un juego:

-condebug. Registra toda la información procesada de la consola en el archivo de texto console.log.

«Definiendo los parámetros de lanzamiento de un juego» en Soporte de Steam

en el mes de noviembre de 2023, no hay rastro del archivo console.log. en su lugar, se encuentra este otro:

tail -f .steam/root/logs/console_log.txt

[2023-11-16 10:20:15] Game process added : AppID 0 "/home/deck/.local/share/Steam/ubuntu12_32/reaper SteamLaunch AppId=4124263896 -- /home/deck/.local/share/Steam/ubuntu12_32/steam-launch-wrapper -- /usr/bin/flatpak run com.dosbox.DOSBox -conf /home/deck/archivo/dos/prince_of_persia/prince.conf", ProcID 1996, IP 0.0.0.0:0
[...]

ajustes del mando

los ajustes del mando se cambian desde el icono del mando de juego que hay en el panel de la derecha de la biblioteca de Steam:

Icono de mando y de configuración
Icono del mando de juego

o desde el menú que aparece con el botón de STEAM durante el juego (esto no funciona en el modo escritorio, que sepa):

STEAM > Dreams in the Witch House > Ajustes del mando > Ajustes del mando

STEAM > Dreams in the Witch House
STEAM > Dreams in the Witch House
Ajustes del mando
Ajustes del mando

en cualquiera de los casos, se debería acceder al siguiente menú, que es donde se realizan los ajustes de mando:

Ajustes del mando > Disposición actual
Ajustes del mando > Disposición actual
modo ratón

si el juego está pensado para su manejo con ratón, hay que escoger la opción Mouse Only (por ejemplo) para que los controles de la Steam Deck respondan como un ratón al uso:

Ajustes del mando > Disposición actual > Plantilla > Cargar nueva disposición > Mouse Only

Cargar nueva disposición > Mouse Only
Ajustes del mando > Disposición actual > Plantilla > Cargar nueva disposición > Mouse Only
Ajustes del mando
Ajustes del mando > Disposición actual > Ver disposición

ilustración y fondo personalizado

modificación manual

la carátula ó ilustración personalizada se puede cambiar desde el modo escritorio: se despliega el menú de contexto sobre la carátula del juego en el panel derecho (en principio, se trata de una caja gris) con el botón L2 (si no se dispone de ratón):

Administrar > Usar ilustración personalizada > Home > archivo > sir_fred > sir_fred.jpg

Administrar > Usar ilustración personalizada
Administrar > Usar ilustración personalizada

el fondo personalizado también se puede cambiar desde el modo escritorio: una vez más, se accede al juego (desde el menú de la izquierda o desde la carátula) y se despliega el menú de contexto sobre el fondo negro del panel de la derecha con el botón L2 (si es que no se dispone de ratón):

Establecer fondo personalizado > Home > archivo > sir_fred > sir_fred_fondo.png

Establecer fondo personalizado
Establecer fondo personalizado

y este es el resultado, en este caso:

Sir Fred (fondo)
Sir Fred (fondo personalizado)
vía steamgriddb

SteamGridDB es una base de datos que ofrece imágenes de miles de juegos:

Download and share custom video game assets and personalize your gaming library.

existe una aplicación, decky-steamgriddb , que permite instalar imágenes de SteamGridDB desde el modo de juego de la Steam Deck:

Easily browse and manage Steam artwork from SteamGridDB or your local files from within gaming mode.

«SteamGridDB plugin for Decky Loader» en SteamGridDB.

basta con descargar Decky Loader, instalarlo y buscar la aplicación en cuestión:

STEAM > Decky > Abrir la tienda de Decky
STEAM > Decky > Abrir la tienda de Decky
STEAM > Decky > Tienda de Decky > Buscar...
STEAM > Decky > Tienda de Decky > Buscar...

Decky (como aparece en las imágenes) se encuentra en el menú de acceso rápido que aparece con el botón ... de la Steam Deck.

luego, en el modo juego, dentro del menú contextual (que se despliega con L2 sobre la carátula del juego o con el icono de configuración del juego), hay que seleccionar la opción «cambiar arte»:

STEAM > Cambiar arte...
STEAM > Cambiar arte...
STEAM > Cambiar arte > Gestionar
STEAM > Cambiar arte > Gestionar

atajos

Mando de Xbox
Mando de Xbox
  • STEAM (botón Xbox) + RT = captura de pantalla.

capturas de pantalla ó screenshots

las capturas de pantalla se archivan en una carpeta local, escondida dentro de ~/.local:

ls -l /home/deck/.local/share/Steam/userdata/{id del usuario}/760/remote/{id del juego}/screenshots

-rwxr-xr-x 1 deck deck 770099 Oct 12  2024 20241012175537_1.jpg
-rwxr-xr-x 1 deck deck 647432 May 28 16:46 20250528164641_1.jpg
-rwxr-xr-x 1 deck deck 92142 Jun 11 16:09 20250611160954_1.jpg
-rwxr-xr-x 1 deck deck 99350 Jun 11 16:10 20250611161006_1.jpg

por ejemplo.

modo escritorio

la combinación de teclas STEAM (botón Xbox) + RT no funciona en el modo escritorio de la Steam Deck: en su lugar, se puede emplear la aplicación Spectacle para la captura de pantallas.

problemario

wifi inestable

si se tienen problemas con el wifi, sobre todo cuando la Steam Deck no está conectada a la corriente, puede deberse al gestor de energía wifi:

STEAM > Parámetros > Sistema > Ajustes del Sistema > Activar modo de desarrollador > ON

una vez activado este modo, hay que desactivar el gestor de energía wifi:

STEAM > Parámetros > Desarrollador (abajo del todo) > Varios > Activar gestión de energía wifi > OFF

SMPTE color bars ó carta de ajuste en lugar de videos

Barras de color SMPTE

al parecer, estas barras aparecen en lugar de un video porque Valve no puede ejecutar ciertos códecs de Windows:

[...] Valve cannot run Window Media Foundation code due to copyright issues. Valve has to covert them to another format.

deaddoof, «Steam Deck TV Color Bars/SMPTE Color Bars fix?» en la Comunidad Steam, 2024.

la solución consiste en instalar Proton GloriousEggroll a través de ProtonUp-Qt en el modo escritorio de Steam Deck:

Inicio > System > Discover > Search… > protonup-qt > ProtonUP-Qt > Install

una vez realizada la instalación, hay que ejecutar ProtonUp-Qt y añadir Proton GloriousEggroll en su última versión:

Add version > Herramienta de compatibilidad > GE-Proton > Versión > GE-Proton9-13 > Instalar

luego, en el modo de juego, basta con activar la compatibilidad con Proton GloriousEggroll en el título problemático para solventar la cuestión:

Propiedades… > Compatibilidad > Forzar el uso de una herramienta especifica de compatibilidad para Steam Play > GE-Proton9-13

fuentes

  • Decky Loader: Steam Deck Homebrew.
  • FAQ en Steam Deck.
  • ProtonDB: gaming know-how from the Linux and Steam Deck community.
  • SteamGridDB: download and share custom video game assets and personalize your gaming library.

Artículos y videos

  • «Allow Flatpaks to Access Your SD Card With Flatseal» en Deck Central, 2022.
  • «Change external keyboard layout for gaming-mode on Steam Deck» en Deckplosion.de, 2023.
  • «Cómo instalar PLUGINS en Steam Deck y qué poder hacer» en HandleDeck, 2025.
  • «La función de Steam Deck 3.5 oculta que permite llegar al modo escritorio más fácil» en HandleDeck, 2023.
  • ainus64, «La guía definitiva de Steam Deck (en español)» en Github, 2022.
  • AntVenom, «Video Recording on the Steam Deck… IT'S EASY NOW!» en YouTube, 2023.
  • Gardiner Bryant, «Ditch the headache. Play your favorite DOS games on the Steam Deck with DOSBox!» en ViewSink, 2022.
  • Jared Newman, «DOS games on Steam Deck: Here’s the best way to do it» en PCWorld, 2023.
  • Scott Louvau, «DOSBox on Steam Deck» en Relentless Optimizer, 2024.
  • rgk, «How to install DOSBox Pure in Steam RetroArch» en la Comunidad Steam, 2022.
  • «Menús radiales» en Steamworks.
  • Prospector Spencer, «Steam Deck - Fixing Rainbow Static Cutscenes While STILL Being in Your Proper Language» en la Comunidad Steam, 2022.
  • Steam Deck en Español, «Actualiza tu Steam Deck de 64GB a 512GB por 75€» en YouTube, 2022.
  • Steam Deck Fans, «Steam Deck - Custom Art Tutorial (Changing the icons/art for games and non-Steam games or apps)» en YouTube, 2022.
  • Triple Indie, «¿Cómo solucionar los problemas de conexión WiFi en Steam Deck?» en YouTube, 2022.
  • Valve, «Take a look inside Steam Deck!» en YouTube, 2021.

Steam

  • Construye tu propia Steam Machine
  • Definiendo los parámetros de lanzamiento de un juego
  • Instrucciones para la recuperación de Steam Deck
  • SteamOS

Etiquetado como Decky Loader, dosbox, flatpak, flatseal, Proton GloriousEggroll, raspberry pi imager, Spectacle, steam, Steam Deck, SteamGridDB, steamos, steamos-readonly
  • proton 6.3
    steam + proton en ubuntu

    Puesto al día el 24 de mayo de 2025. instalación steam apt sudo apt show…

  • DOSBox
    dosbox

    Puesto al día el 1 de abril del 2024. sudo apt show dosbox DOSBox is…

RSS rutas fuera

  • Beats and yelling: Imprecation 4 de septiembre de 2025 Hate Meditations
  • Obsolete tears 2 de septiembre de 2025 Hate Meditations
  • Beats and yelling: Drawn and Quartered 1 de septiembre de 2025 Hate Meditations
  • Javier Resines en Espacio en Blanco: Alejandro Magno, Jordi Magraner y los yetis. 1 de septiembre de 2025 Javier Resines
  • Shipping Update For Our U.S Supporters 30 de agosto de 2025 hessianfirm
  • Jürgen Bartsch (1976-2025) 28 de agosto de 2025 hessianfirm
  • Nils “Nisse” Karlén (1974-2025) 27 de agosto de 2025 Raphael Alecto
  • Beats and yelling shorts, 27th August 25 27 de agosto de 2025 Hate Meditations
  • Nils “Nisse” Joel Karlén (1974-2025) 26 de agosto de 2025 Brett Stevens

Archivo

cuaderno de campo 2011-2025