Skip to content

vixalien/muzika

Repository files navigation

Muzika

Muzika is an elegant music streaming app.

Muzika home page

Muzika playing "My Queen is Angela Davis"

Note: This is a work in progress. The app is not yet ready for production.

Features

  • Personalized home screen
  • Search for songs, albums, artists, radios and playlists
  • Login with Google and access your playlists and more from your library
  • Play personalized radios & mixes
  • View song lyrics & related information
  • Browse artists, albums and playlists etc.

Installation

Using the latest Nightly Flatpak

You can download the latest Nightly flatpak.

From source

Dependencies:

  • GNOME Builder
  1. Clone the repository
git clone https://github.com/vixalien/muzika.git --recurse-submodules
  1. Open the project in GNOME Builder and use "Build" to build the project.

Note: Using Meson and Ninja directly is no longer supported because Muzika uses the latest (unreleased) libadwaita components.

Navigation

Muzika has a robust navigator that allows you to navigate through different pages by using muzika URIs. Some of them are documented below.

The muzika URI has the form muzika:endpoint:data. URIs can also have query parameters. For example, muzika:library?view=grid will open the library page with the grid view.

You can navigate to a muzika URI by directly typing it in the search bar and muzika will visit that page directly instead of searching it.

You can also navigate to a given endpoint by triggering the navigator action manually:

  1. Open the GTK inspector by pressing Ctrl Shift I.
  2. Click on the Actions tab on the right.
  3. Look for the action named navigator.visit and type in your URI in the Parameter field, then click Activate.

Endpoints

A list of all endpoints are here.

  • muzika:home - Home page
  • muzika:playlist:<playlistId> - Playlist page. eg: muzika:playlist:PL4fGSI1pDJn6puJdseH2Rt9sMvt9E2M4i/
  • muzika:album:<albumId> - Album page.
  • muzika:artist:<channelId> - Artist or Channel page.
  • search:<query> - Search. Note that query must be URL encoded. eg: search:hello world searches for hello world.
  • muzika:library - Library.

More endpoints will be added as Muzika supports more features.