dexonlinux 1.0.1

DexOnLinux is a tool that allows you to stream Samsung DeX from your Samsung device to your Linux PC, controlling it with your mouse and keyboard, and interacting with it as if it were a native application on your desktop.

DexOnLinux

Got Samsung DeX on your device? What if you could stream directly on your Linux PC and use your mouse and keyboard to control it? DexOnLinux makes this possible in the easiest way possible.

What is DexOnLinux?

DexOnLinux is a tool that allows you to stream Samsung DeX from your Samsung device to your Linux PC, controlling it with your mouse and keyboard, and interacting with it as if it were a native application on your desktop.

How does it work?

DexOnLinux uses several different components to achieve this such as:

• miraclecast: A tool for Wi-Fi Direct connections, allowing your Linux PC to connect to your Samsung device.
• scrcpy: A display and control application for Android devices, enabling screen mirroring and input control.
• pydbus: A Python library for D-Bus, which makes it easier to read data or catch events from Miraclecast services.

How to install and run

This project requires Python 3.9 or higher, pip, and git to be installed on your system and root privileges to install some dependencies.

The installation process is pretty easy, just follow the steps below. At the moment everything has been tested only on Ubuntu 24.04, but it should work on other distributions as well.

---

1. Clone the repository

git clone https://github.com/gabdevele/DexOnLinux.git

---

2. Navigate to the project directory

cd DexOnLinux    

---

3. Installation options

Now you have two options, either install it using the provided script or manually install the dependencies and run it directly from the source code.

Installation script only works on Ubuntu 24.04.

Option 1: Using the installation script (Ubuntu 24.04 only)

1. Make the scripts executable:

   chmod +x ./scripts/install.sh
   chmod +x ./scripts/run.sh
   

2. Run the installation script:

   sudo ./scripts/install.sh
   

---

Option 2: Manual installation

Since the manual installation relies on external dependencies, I'll link the official installation guides for each of them.

• miraclecast
• scrcpy
• PyGObject

After installing these dependencies you will need to install Python dependencies with uv:

uv sync --no-dev --locked

For development tools:

uv sync --group dev --locked

---

4. Run DexOnLinux

Keep in mind that your network connection will be temporarily disabled while this tool is running.

./scripts/run.sh

or, after activating the virtual environment:

dexonlinux

From the repository you can also run:

uv run dexonlinux

When DexOnLinux is published on PyPI, the Python package installation will be:

pip install dexonlinux
dexonlinux

Useful CLI options:

dexonlinux --interface wlan0 --device R5CN1234567
dexonlinux --fullscreen
dexonlinux --display-id 2
dexonlinux --debug --log-file dexonlinux.log
dexonlinux --no-banner --no-color

CLI behavior

DexOnLinux now performs dependency, Wi-Fi P2P, sudo, and ADB checks before disabling network services. Before the network is disabled, the CLI asks for confirmation unless you pass --yes.

If the session exits normally, on Ctrl+C, or after a startup error, DexOnLinux attempts to stop the Miraclecast processes it started and restore NetworkManager and wpa_supplicant.

Troubleshooting

• If your phone appears as unauthorized, accept the ADB authorization prompt on the device and refresh.
• If your phone appears as offline, reconnect USB and restart ADB with adb kill-server && adb start-server.
• If scrcpy opens the wrong display, reconnect DeX and pass --display-id <id> after checking the display list shown by the CLI.
• If networking is not restored, run sudo systemctl start NetworkManager wpa_supplicant.