1. 15 May, 2018 14 commits
  2. 13 May, 2018 1 commit
  3. 12 May, 2018 3 commits
  4. 10 May, 2018 6 commits
  5. 09 May, 2018 12 commits
    • Eliot Berriot's avatar
      Merge tag '0.12' into develop · db4c1356
      Eliot Berriot authored
      0.12 (2018-05-09)
      -----------------
      
      Upgrade instructions are available at
        https://docs.funkwhale.audio/upgrading.html
      
      Features:
      
      - Subsonic API implementation to offer compatibility with existing clients such
        as DSub (#75)
      - Use nodeinfo standard for publishing instance information (#192)
      
      Enhancements:
      
      - Play button now play tracks immediately instead of appending them to the
        queue (#99, #156)
      
      Bugfixes:
      
      - Fix broken federated import (#193)
      
      Documentation:
      
      - Up-to-date documentation for upgrading front-end files on docker setup (#132)
      
      Subsonic API
      ^^^^^^^^^^^^
      
      This release implements some core parts of the Subsonic API, which is widely
      deployed in various projects and supported by numerous clients.
      
      By offering this API in Funkwhale, we make it possible to access the instance
      library and listen to the music without from existing Subsonic clients, and
      without developping our own alternative clients for each and every platform.
      
      Most advanced Subsonic clients support offline caching of music files,
      playlist management and search, which makes them well-suited for nomadic use.
      
      Please head over :doc:`users/apps` for more informations about supported clients
      and user instructions.
      
      At the instance-level, the Subsonic API is enabled by default, but require
      and additional endpoint to be added in you reverse-proxy configuration.
      
      On nginx, add the following block::
      
          location /rest/ {
              include /etc/nginx/funkwhale_proxy.conf;
              proxy_pass   http://funkwhale-api/api/subsonic/rest/;
          }
      
      On Apache, add the following block::
      
          <Location "/rest">
              ProxyPass ${funkwhale-api}/api/subsonic/rest
              ProxyPassReverse ${funkwhale-api}/api/subsonic/rest
          </Location>
      
      The Subsonic can be disabled at the instance level from the django admin.
      
      .. note::
      
          Because of Subsonic's API design which assumes cleartext storing of
          user passwords, we chose to have a dedicated, separate password
          for that purpose. Users can generate this password from their
          settings page in the web client.
      
      Nodeinfo standard for instance information and stats
      ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
      
      .. warning::
      
          The ``/api/v1/instance/stats/`` endpoint which was used to display
          instance data in the about page is removed in favor of the new
          ``/api/v1/instance/nodeinfo/2.0/`` endpoint.
      
      In earlier version, we where using a custom endpoint and format for
      our instance information and statistics. While this was working,
      this was not compatible with anything else on the fediverse.
      
      We now offer a nodeinfo 2.0 endpoint which provides, in a single place,
      all the instance information such as library and user activity statistics,
      public instance settings (description, registration and federation status, etc.).
      
      We offer two settings to manage nodeinfo in your Funkwhale instance:
      
      1. One setting to completely disable nodeinfo, but this is not recommended
         as the exposed data may be needed to make some parts of the front-end
         work (especially the about page).
      2. One setting to disable only usage and library statistics in the nodeinfo
         endpoint. This is useful if you want the nodeinfo endpoint to work,
         but don't feel comfortable sharing aggregated statistics about your library
         and user activity.
      
      To make your instance fully compatible with the nodeinfo protocol, you need to
      to edit your nginx configuration file:
      
      .. code-block::
      
          # before
          ...
          location /.well-known/webfinger {
              include /etc/nginx/funkwhale_proxy.conf;
              proxy_pass   http://funkwhale-api/.well-known/webfinger;
          }
          ...
      
          # after
          ...
          location /.well-known/ {
              include /etc/nginx/funkwhale_proxy.conf;
              proxy_pass   http://funkwhale-api/.well-known/;
          }
          ...
      
      You can do the same if you use apache:
      
      .. code-block::
      
          # before
          ...
          <Location "/.well-known/webfinger">
            ProxyPass ${funkwhale-api}/.well-known/webfinger
            ProxyPassReverse ${funkwhale-api}/.well-known/webfinger
          </Location>
          ...
      
          # after
          ...
          <Location "/.well-known/">
            ProxyPass ${funkwhale-api}/.well-known/
            ProxyPassReverse ${funkwhale-api}/.well-known/
          </Location>
          ...
      
      This will ensure all well-known endpoints are proxied to funkwhale, and
      not just webfinger one.
      
      Links:
      
      - About nodeinfo: https://github.com/jhass/nodeinfo
      db4c1356
    • Eliot Berriot's avatar
      Merge branch 'release/0.12' · 107cca7b
      Eliot Berriot authored
      107cca7b
    • Eliot Berriot's avatar
      0.12 Version bump and changelog · 0997aa4b
      Eliot Berriot authored
      0997aa4b
    • Eliot Berriot's avatar
      Merge branch '75-subsonic-api' into 'develop' · 805f9c6b
      Eliot Berriot authored
      Resolve "Implement the subsonic API"
      
      Closes #75
      
      See merge request funkwhale/funkwhale!188
      805f9c6b
    • Eliot Berriot's avatar
      Updated demo script · 12638e1d
      Eliot Berriot authored
      12638e1d
    • Eliot Berriot's avatar
      Fix #75: changelog · 60412ad5
      Eliot Berriot authored
      60412ad5
    • Eliot Berriot's avatar
      See #75: User documentation · a5ebf56f
      Eliot Berriot authored
      a5ebf56f
    • Eliot Berriot's avatar
    • Eliot Berriot's avatar
    • Eliot Berriot's avatar
      Dev setup for working with subsonic API · 632aca51
      Eliot Berriot authored
      632aca51
    • Eliot Berriot's avatar
      67dc414c
    • Eliot Berriot's avatar
  6. 08 May, 2018 4 commits