Quick Lofi

Play lofi music and other sounds, locally or online, on your GNOME desktop with just a click!

Demo

quick-lofi-demo.webm

Features

• Play lofi and any other sound with one click
• Global keyboard shortcuts for quick control
• Volume control directly from pop-up menu
• Drag and drop to rearrange radio stations
• Adjustable pop-up height

Dependencies

This extension requires mpv. Install it using your package manager:

# Fedora
sudo dnf install mpv

# Debian/Ubuntu
sudo apt install mpv

# Arch
sudo pacman -S mpv

# openSUSE
sudo zypper install mpv

Installation

Via EGO

1. Install from the extension page using the browser integration or the Extension Manager.

From the release .zip

1. Download quicklofi@eucaue.zip from the releases page.

2. Run in the same folder:

   gnome-extensions install --force quicklofi@eucaue.zip

3. Log out and back in.

Manual installation

You’re installing the latest release, which may not work on older GNOME versions, check the release notes. Requires Node and NPM.

1. Clone the repository:

   git clone https://github.com/EuCaue/gnome-shell-extension-quick-lofi.git

2. Install dependencies:

   npm install

3. Build and install:

   npm run compile-schemas && npm run prod:install

4. Log out and back in.

---

Development

Requires Node and NPM.

Set up a local environment to work on the extension:

1. Clone the repository:

   git clone https://github.com/EuCaue/gnome-shell-extension-quick-lofi.git
   cd gnome-shell-extension-quick-lofi

2. Install dependencies:

   npm install

3. Build and run the extension in a nested GNOME Wayland session:

   npm run dev

---

Contributing

Contributions are always welcome! 💡

1. Fork the repository and create a new branch for your changes.
2. Make your improvements whether it’s fixing a bug, improving code, or adding a feature.
3. Commit and push your changes to your branch.
4. Open a pull request with a short description of what you’ve done.
5. If you find any bugs or have ideas, feel free to open an issue anytime!

---

Made with ❤️ by EuCaue