Desktopify is a versatile script to convert Ubuntu Server for the Raspberry Pi to one of the official Ubuntu desktop flavours.
Desktopify helps in setting up a full Ubuntu Desktop environment on a Raspberry Pi. Initially created as a proof of concept, it has now evolved to support multiple Ubuntu desktop flavours.
- Download an Ubuntu Server image for Raspberry Pi and write it to an SDHC card.
- Boot the Ubuntu Server SDHC on a Raspberry Pi 2, 3, or 4.
- Log in to the Raspberry Pi using:
- Username:
ubuntu
- Password:
ubuntu
- You will be prompted to change the password.
- Username:
- Clone the project:
git clone https://github.com/urquiaernesto/desktopify.git cd desktopify sudo ./desktopify --de ubuntu-mate
./desktopify --de <desktop environment>
Available desktop environments:
lubuntu
kubuntu
ubuntu
ubuntu-budgie
ubuntu-kylin
ubuntu-mate
ubuntu-studio
xubuntu
You can also pass the optional --oem option which will run a setup wizard on the next boot.
Use --uninstall to remove the currently installed desktop environment.
Installs the specified desktop environment:
sudo ./desktopify --de ubuntu-mate
Uninstalls the currently installed desktop environment:
sudo ./desktopify --uninstall
Runs an OEM setup wizard on the next boot:
sudo ./desktopify --de ubuntu-mate --oem
- Installed GPIO utilities and libraries
- Enabled Bluetooth
- Made Network Manager the default backend
- Prevented low power WiFi mode
- Disabled overscan
- Enabled fkms driver
- Enabled boot splash
- Enabled Firefox hardware acceleration
- Created a snap package
- Supported desktop environments:
- Kubuntu
- Lubuntu
- Ubuntu
- Ubuntu Budgie
- Ubuntu Kylin
- Ubuntu MATE
- Ubuntu Studio
- Xubuntu
- Optimized Ubuntu MATE (Marco) window manager
- Enabled initial setup
- Prevented pointless re-installs
- Installed snaps
- Installed gpio tools
install_desktop_environment()
: Installs the specified desktop environment.uninstall_desktop_environment()
: Uninstalls the currently installed desktop environment.apply_tweaks()
: Applies specific tweaks for the installed desktop environment.configure_network()
: Configures network settings and disables WiFi power saving.display_menu()
: Displays a menu for selecting the desktop environment.
Install Ubuntu MATE with OEM setup:
sudo ./desktopify --de ubuntu-mate --oem
Uninstall the current desktop environment:
sudo ./desktopify --uninstall
Feel free to contribute to the project by submitting issues or pull requests on GitHub.
This project is licensed under the MIT License - see the LICENSE file for details.
You can copy and paste this entire block into your README.md file on GitHub. If you need any further adjustments, let me know.