Google+ page Facebook page Twitter page RSS feed

Nuvola Player
Cloud music integration for your Linux desktop

Rolling Releases are for PremiumPatron users

Rolling Releases are provided for Premium/Patron users as a benefit for their support. You will need to enter credentials of your Tiliado account with active Nuvola Premium or Patron plan to access these builds.

Nuvola Apps 3.1 was forked from release 3.0 on December 30, 2015 and many changes under the hood have been made and many new features & enhancements have been added since then.

About Nuvola Apps

Nuvola Apps is a runtime for web-based music streaming services providing more native user experience and integration with Linux desktop environments than usual web browsers can offer. It tries to feel and look like a native application as possible. However, it cannot overcome common drawbacks of web-based music streaming: some music streaming services require Flash plugin and web apps usually have higher memory usage than native apps.

What's New

Nuvola 3.1 is constantly evolving, to stay in touch

Milestone 3.1.4

The milestone 3.1.4 was released as Nuvola 4.4 on May 27, 2017.

New Features

  • Tray icon feature can now use AppIndicator library instead of obsolete X11 tray icons. Although app indicators are mostly known from Ubuntu's Unity desktop, they also work in elementaryOS and GNOME Shell (with AppIndicator extension) and provide superior user experience. Issue: tiliado/nuvolaplayer#45
  • Users can easily clear cookies, cache and temporary files, IndexedDB and WebSQL databases and local storage from the Preferences dialog → tab Website Data. Issue: tiliado/nuvolaplayer#331


  • Versioning scheme was changed to be more compact, e.g. 4.4.1 instead of 3.1.4-1.gabcd. Nuvola 4.0 was re-targeted as Nuvola 5.0.
  • Nuvola can do its own user agent quirks (i.e. to disguise itself as a different web browser) in order to work around web pages that doesn't work with the WebKit's user agent string. Issue: tiliado/nuvolaplayer#336
  • Flatpak builds use the latest stable WebKitGTK+ 2.16.3 bringing fixes for three security vulnerabilities as well as several crashes and rendering issues.

Web App Scripts

  • Google Play Music script uses own user agent quirks to work around the malfunctioning Google sign-in web page. Issue: tiliado/nuvolaplayer#336

Bug fixes

  • The build script now raises error if it is ran with Python < 3.4.
  • Fixed a bug when the menus of tray icons and dock items were not updated.
  • Nuvola now aborts when required data files are not found (e.g. in incomplete installation) rather they running with errors in the background.
  • Obsolete test suite has been removed. A new one will be created during ongoing modernization. Issue: tiliado/nuvolaplayer#335
  • Broken -L/--log-file options were removed. Issue: tiliado/nuvolaplayer#338
  • Various fixes of HTTP Remote Control feature.

Under the Hood

  • Nuvola's filesystem namespace was changed from nuvolaplayer3 to nuvolaruntime. The data dir is installed at PREFIX/share/nuvolaruntime, libraries were renamed to libnuvolaruntime-*.so and binaries to nuvola(ctl). Users' configuration, data and cache is migrated automatically.
  • Nuvola's git repository was moved to
  • WebKitGTK+ >= 2.16.0 is required as all new API is now used unconditionally to make maintenance easier.
  • Added optional dependency on appindicator3-0.1 >= 0.4. Use ./waf configure --noappindicator to disable this dependency and related functionality (Tray icon feature).
  • Nuvola no longer bundles JavaScript library but expect version 3.1.0 of it located at the JSDIR/ (JSDIR is DATADIR/javascript unless changed with --jsdir). Issue: tiliado/nuvolaplayer#341
  • Nuvola no longer supports web app scripts without a desktop file.
  • Test suite was reintroduced (build/run-nuvolaruntime-tests). Issue: tiliado/nuvolaplayer#335
  • A lot of refactoring and removal of obsolete code and other improvements.

Nuvola SDK 4.4.0

  • Versioning scheme is synchronized with Nuvola Apps Runtime.
  • DBus Launcher has been ported to use the high level Start-up API of Nuvola and a data service have been removed because it is no longer used.
  • Compatibility with Nuvola Player 3.0.x must be enabled with the --compat flag passed to ./configure.
  • Web apps scripts are installed into the PREFIX/share/nuvolaruntime/web_apps directory used by Nuvola 4.4+ but legacy symlinks in the PREFIX/share/nuvolaplayer3/web_apps directory are also provided for Nuvola 3.x.

Diorite 4.4.0

  • Versioning scheme is synchronized with Nuvola Apps 4.4. Library names have been changed accordingly: dioriteglib-0.3 → dioriteglib4 and dioritegtk-0.3 → dioritegtk4.
  • Vala documentation is built by default. Requires valadoc >= 0.36 but can be disabled with --novaladoc flag.
  • Various utility functions were added. See git log for details.

Milestone 3.1.3

The milestone 3.1.3 was released on April 30, 2017.

New Features

  • elementaryOS Loki has been added among officially supported distributions. Nuvola flatpaks contain a work-in-progress GTK+ 3.22 port of the elementary theme to provide elementaryOS users with a native look. Installation instructions and documentation have been updated accordingly. Issue: tiliado/nuvolaplayer#4
  • All three variants of the Arc theme have been added to Nuvola flatpaks. Issue: tiliado/nuvolaplayer/issues/318


  • Ubuntu themes have been updated. Issue: tiliado/nuvolaplayer#324
  • Initial start-up of flatpak builds is faster.
  • The text of Welcome dialog was moved to the first tab of the main window because it may contain useful information.
  • WebKitGTK+ 2.16 API to set network proxy is used replacing previous legacy hacks.
  • The official builds of Nuvola are marked as "genuine flatpak builds"

Bug fixes

  • Apps that are not media players no longer steal media keys. Issue: tiliado/nuvolaplayer#230
  • Fixed activation for Premium users. Issue: tiliado/nuvolaplayer#325
  • App menu, toolbar & menu bar handling was refactored and double app menus fixed. Issue: tiliado/diorite#4

Under the Hood

  • Build script of Nuvola was reworked, ported to Waf 1.9.10 and supports branding. See for more information.
  • Build script of Diorite was reworked and ported to Waf 1.9.10. See Diorite's for more information.
  • Modernisation has begun. Dependencies were raised and legacy code is being removed.
  • All Python scripts require Python >= 3.4.
  • Code has been ported to Valac 0.36.

Milestone 3.1.2

The milestone 3.1.2 was released on March 26, 2017 (123 commit since the 3.1.1 milestone).

New Features

  • Nuvola Player was renamed to Nuvola Apps as non-media player apps (Google Calendar) were enabled and should be fully supported in the 4.0 release.
  • Nuvola Apps are distributed as cross-distribution flatpak builds. There have been a lot of changes under the hood to support this transition.
  • The nuvolaplayer3 and nuvolaplayer3ctl commands are deprecated in favor of nuvola and nuvolactl.
  • WebApp scripts provide own desktop files so the unnecessary create/delete desktop launchers actions were removed.


  • Enhanced support of HTML5 Audio and Media Source Extension (MSE), which is currently enabled only in the BBC iPlayer script with a custom WebKitGTK+ build.
  • Album art is downloaded with WebKit's NetworkProcess to access images that are otherwise restricted. Issue: tiliado/nuvolaplayer#76
  • Preferences dialog: Components tab was renamed to Features as it is more user-friendly.

Under the Hood

  • Inter-process communication has been reworked for greater flexibility as required by the HTTP Remote Control feature.
  • Nuvola and individual apps are DBus-activatable.
  • The unique name has been changed to eu.tiliado.Nuvola and most of the resources (e.g. icons) use this name.
  • AppData/AppStream metadata have been updated.
  • The build script now honors the VAPIDIR env variable.
  • Added a script to set up Nuvola CDK environment (

Bug Fixes

  • "Too many flash plugins" false positives. Resolve symlinks and track final paths not to count duplicates. Issue: tiliado/nuvolaplayer#159
  • Repeated Runner: prefix in debugging output. Issue: tiliado/nuvolaplayer#265
  • Disable LIBGL_DRI3_DISABLE workaround with WebKitGTK 2.14+ to fix performance issues. Issue: tiliado/nuvolaplayer#260

News for Script Maintainers

  • Documentation has been updated and Mantainer's Guide merged into the tutorial.
  • Format requirements flag were implemented but not yet documented.
  • Web app scripts are built with Nuvola SDK.

Milestone 3.1.1

The milestone 3.1.1 was released on October 2016.

New Features

Ability to both display and set track rating in Media Player Indicator GNOME Shell extension
Providing a streaming service supports it, Nuvola Player 3.1 exports track rating in MPRIS interface and a custom method to set rating of a track. Note that as of October 30th 2016, Player Indicator git master version is required.
HTTP Remote Control interface
This interface allows creation of client apps to control Nuvola Player over network via an socket.
Media Player Controller web page
This page is an example of a client using the HTTP Remote Control interface. It allows you to control Nuvola Player from any device with a web browser (e.g. a phone).
Nuvola Controller Pebble Watchapp
This app for Pebble watches is another example of a client using the HTTP Remote Control interface. It allows you to control Nuvola Player from your wrist.
Password Manager
With the Password Manager, you can store passwords from login forms in a secure keyring.


  • An option to always run in background regardless a song is playing or not. See in action in Unity or GNOME.
  • Better support of HTML5 Audio. It is sufficient for ownCloud Music web app but more work is still necessary to support Google Play Music. Issue: tiliado/nuvolaplayer#52
  • Pop-up windows are allowed to pop up a new window, which is required by the SoundCloud's log-in-via-Google feature. Issue: tiliado/nuvola-app-soundcloud#3
  • A hint how to edit or remove a keyboard shortcut. Issue: tiliado/nuvolaplayer#217
  • Users can disable media keys bindings in the Preferences dialog. Issue: tiliado/nuvolaplayer#237
  • Inter process communication backed has been rewritten.
  • All web app scripts have been ported to comply with the latest guidelines.
  • Packaging improvements: support of independent installation of individual scripts and correct package metadata (e.g. license and homepage).

Bug Fixes

  • Remove config option --with-appindicator as the AppIndicator integration is currently unmaintained. Issue: tiliado/nuvolaplayer#201, tiliado/nuvolaplayer#45
  • Add missing -a/--app-id command-line argument to the --help screen. Issue: tiliado/nuvolaplayer#147
  • MPRIS implementation of CanPlay and CanPause flags has been fixed. Issue: tiliado/nuvolaplayer#224
  • Warnings when Notifications is being disabled has been removed. Issue: tiliado/nuvolaplayer#227
  • Don't use notifications API if disabled as it produces critical warnings. Issue: tiliado/nuvolaplayer#227
  • Set GDK_BACKEND to x11 not to crash under Wayland. Issue: tiliado/nuvolaplayer#181
  • Disable compositing mode in WebKitGTK < 2.13.4 as it may crash some websites. Issue: tiliado/nuvolaplayer#245

News for Script Maintainers:

  • Web app integration template has been moved to its own repository.
  • Added information about Format Requirements Flags. Issue: tiliado/nuvolaplayer#158
  • Nuvola.VERSION property contains Nuvola version encoded as single integer, e.g. e.g. 30105 for 3.1.5.
  • Nuvola.API_VERSION property contains Nuvola API version encoded as single integer, e.g. e.g. 301 for 3.1.
  • Nuvola.WEBKITGTK_{VERSION,MAJOR,MINOR,MICRO} properties contain version information about WebKitGTK+ library.
  • Nuvola.LIBSOUP_{VERSION,MAJOR,MINOR,MICRO} properties contain version information about Soup library.
  • New API to set rating.
  • It is possible to set a user agent string via the user_agent field of metadata.json. Issue: tiliado/nuvolaplayer#91
  • It is possible to enable access to insecure content. This happens when a web page loaded over HTTPS protocol loads any content over HTTP protocol.
  • Developer documentation and guidelines have been updated.

Changes in Dependencies

  • Increased: WebKitGTK >= 2.6.2, Valac >= 0.26.1, GLib >= 2.42.1 and GTK+ >= 3.14.5.
  • New: libuuid and libnm-(util/glib)

Install Nuvola

Nuvola project provides cross-distribution flatpak packages of Nuvola 3.1, which contain all requires dependencies. In order to install a particular Nuvola app, follow steps in the Nuvola Apps Repository Index portal according to your distribution:

Questions? Feedback?

Having trouble? We'd like to help! Search for information in the archives of the Nuvola Player Users mailing list, or post a question.