# UxPlay

# Installing UxPlay on Linux

<span style="white-space: pre-wrap;">This guide explains how to:</span>

- <span style="white-space: pre-wrap;">**Install UxPlay** on Fedora</span>
- <span style="white-space: pre-wrap;">**Create a launch script**</span>
- <span style="white-space: pre-wrap;">**Create a .desktop launcher** so UxPlay appears in the **Apps** menu</span>
- <span style="white-space: pre-wrap;">**Run UxPlay in the background** without freezing the launcher</span>

#### Install UxPlay and create Launch Script

1. <span style="white-space: pre-wrap;">Open Terminal and run</span>

```bash
sudo dnf install uxplay
```

2. <span style="white-space: pre-wrap;">Create a folder for custom scripts. Fedora doesn’t always include a ~/bin folder by default, so create it:</span>

```bash
mkdir -p ~/bin
```

3. Create UxPlay script

```bash
nano ~/bin/start-uxplay.sh
```

In nano add

```bash
#!/bin/bash
nohup uxplay >/dev/null 2>&1 &
```

4. Save and Exit
5. Make it executable

```bash
chmod +x ~/bin/start-uxplay.sh
```

#### Create desktop app launcher

1. Create Directory

```bash
mkdir -p ~/.local/share/applications
```

2. Create a launcher

```bash
nano ~/.local/share/applications/uxplay.desktop
```

In nano add

```bash
[Desktop Entry]
Type=Application
Name=UxPlay
Comment=Start the UxPlay AirPlay receiver
Exec=/home/YOURUSERNAME/bin/start-uxplay.sh
Icon=video-display
Terminal=false
Categories=AudioVideo;
```

3. Save and Exit
4. Make launcher executable

```bash
chmod +x ~/.local/share/applications/uxplay.desktop
```

5. Refresh application database

```bash
update-desktop-database ~/.local/share/applications/
```

To Stop UxPlay simply run command in terminal

```bash
pkill uxplay
```

# Run UxPlay as a systemd service

<span style="white-space: pre-wrap;">This method gives you:</span>

- <span style="white-space: pre-wrap;">**systemctl start uxplay**</span>
- <span style="white-space: pre-wrap;">**systemctl stop uxplay**</span>
- <span style="white-space: pre-wrap;">**systemctl restart uxplay**</span>
- <span style="white-space: pre-wrap;">Optional **auto‑start on boot**</span>
- <span style="white-space: pre-wrap;">Clean background operation with no terminal needed</span>

#### <span style="white-space: pre-wrap;">Create a systemd service file</span>

1. <span style="white-space: pre-wrap;">Open Service file</span>

```bash
sudo nano /etc/systemd/system/uxplay.service
```

<span style="white-space: pre-wrap;">In Nano Paste following command editing yoursuername</span>

```bash
[Unit]
Description=UxPlay AirPlay Receiver
After=network.target

[Service]
Type=simple
User=YOURUSERNAME
ExecStart=/usr/bin/uxplay
Restart=on-failure

[Install]
WantedBy=multi-user.target
```

2. <span style="white-space: pre-wrap;">Reload systemd</span>

```bash
sudo systemctl daemon-reload
```

Optional: Enable auto start on boot

```bash
sudo systemctl enable uxplay
```

#### Systemd Commands for UxPlay

- Start

```bash
sudo systemctl start uxplay
```

- Stop

sudo systemctl stop uxplay

```bash
sudo systemctl stop uxplay
```