Skip to main content

Dual-booting Debian on a Steam Deck, easily.

Project description

deckian

Matrix

Dual-booting Debian on a Steam Deck, easily.

deckian + KDE Plasma

Why?

When I got my Steam Deck, I tried to dual-boot Debian stable on it with the official installer.

However, the installer was stretched (and in the incorrect rotation!) and it didn't look like it was going to work.

I eventually tried installing Ubuntu on it, and most things were working correctly - But there was no sound, and I couldn't use the controller as an actual controller.

At that point, I decided to just make a script that can install Debian to an SD Card and automatically fix all of the driver issues I had with it.

Installation

After cloning this repository, run the following to install deckian to /dev/sda with the username user (change it to the correct values for your use case first!):

sudo python3 -m deckian bootstrap
sudo python3 -m deckian install-desktop plasma
sudo python3 -m deckian push deckian-plasma
sudo python3 -m deckian install deckian-plasma /dev/sda --username=user

Credits

@iam_tj:matrix.org: Converted the spi-amd kernel module into a dkms module

Known issues

  • The built-in speaker does not work
  • GNOME (and even gdm) crashes
  • XFCE doesn't have a way to disable wireless (as a solution for this problem, I've added rfkill to the list of packages installed by deckian bootstrap)

Features

Feature Works? Notes
Display Yes Display rotation is broken, but deckian install-desktop handles that automatically.
Wireless Yes On XFCE, you can't turn off wireless. However, you can turn it off with rfkill.
Audio Partially HDMI audio works automatically. You will need to run audiofix before headphone audio works, and the built-in speaker currently does not work at all.
Controller No The Steam Deck controller simulates a keyboard and mouse by default. Disabling that and using it as an actual controller does not work yet.

Desktop environments

Desktop Environment Works? Notes
KDE Plasma Yes KDE Plasma currently is the best DE choice for deckian, everything works really well.
XFCE Yes Wireless cannot be disabled with the GUI, but everything else works.
GNOME No GNOME crashes when it tries to load gdm.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

deckian-0.0.1.tar.gz (48.0 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

deckian-0.0.1-py3-none-any.whl (38.2 kB view details)

Uploaded Python 3

File details

Details for the file deckian-0.0.1.tar.gz.

File metadata

  • Download URL: deckian-0.0.1.tar.gz
  • Upload date:
  • Size: 48.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.11.2

File hashes

Hashes for deckian-0.0.1.tar.gz
Algorithm Hash digest
SHA256 f2982778bf7e2c493dd40686dc6b96b35aa5f35b0b199b2c430e81bb43ad79c3
MD5 7429d3acb204287348fb3dcec20c8d39
BLAKE2b-256 938666831d8ff889b79c10fae6e3c49bc2597c193200245fe643df5a79fc0c8f

See more details on using hashes here.

File details

Details for the file deckian-0.0.1-py3-none-any.whl.

File metadata

  • Download URL: deckian-0.0.1-py3-none-any.whl
  • Upload date:
  • Size: 38.2 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.11.2

File hashes

Hashes for deckian-0.0.1-py3-none-any.whl
Algorithm Hash digest
SHA256 6da8999b38c075fef1d7742deae58685c71a47deea6f55f39da0e140ea3f30f1
MD5 7889c6389d21dddf0370f372e2995efa
BLAKE2b-256 61ffb58c9887adc56eeaf97046fd1d8502b54db7b8cc399c67ed598347d5dab8

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page