# 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
```