MirrorMirror
/
funkwhale
mirror of https://dev.funkwhale.audio/funkwhale/funkwhale.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

Merge branch 'master' into develop

This commit is contained in:
Eliot Berriot 2020-04-09 09:20:14 +02:00
parent b589ed4bb9 5c10d8e3f7
commit de22fb79c6
No known key found for this signature in database
GPG Key ID: 6B501DFD73514E14
3 changed files with 29 additions and 29 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

38
docs/admin/0.17.rst
View File

@ -58,7 +58,7 @@ with other users, both from the same instance or from the federation.
We think this change will have a really positive impact: We think this change will have a really positive impact:
- Admins should be more encline to open their instance to strangers, because copyrighted media - Admins should be more inclined to open their instance to strangers, because copyrighted media
can be upload and shared privately can be upload and shared privately
- Creators should have a better experience when joining the network, because they can now - Creators should have a better experience when joining the network, because they can now
upload their own content and share it over the federation without any admin intervention upload their own content and share it over the federation without any admin intervention
@ -70,12 +70,12 @@ Accessing music
From an end-user perspective, you will be able to browse any artist or album or track From an end-user perspective, you will be able to browse any artist or album or track
that is known by your instance, but you'll only be able to listen to content that is known by your instance, but you'll only be able to listen to content
that match one of those critaeria: that match one of those criteria:
- The content is available is one of your libraries - The content is available is one of your libraries
- The content is available in a public library - The content is available in a public library
- The content is available in one library from your instance that has a visibility level set to "instance" - The content is available in one library from your instance that has a visibility level set to "instance"
- The content is available in one of the library you follow - The content is available in one of the libraries you follow
Following someone else's library is a four step process: Following someone else's library is a four step process:
@ -104,35 +104,35 @@ A better import UI
------------------ ------------------
This version includes a completely new import UI which should make This version includes a completely new import UI which should make
file uploading less annoying. Especially it's updating in real-time file uploading less annoying. In particular, the UI updates in real-time
and has a better error reporting. and has a better error reporting.
A Better import engine A better import engine
---------------------- ----------------------
Funkwhale is known for its quircks during music import. Missing covers, Funkwhale is known for its quircks during music import. Missing covers,
splitted albums, bad management of tracks with multiple artists, missing split albums, bad management of tracks with multiple artists, missing
data for files imported over federation, bad performance, discrepencies between data for files imported over federation, bad performance, discrepancies between
the user provided tags and what is actually stored in the database... the user-provided tags and what is actually stored in the database...
This should be greatly improved now, as the whole import logic was rewritten This should be greatly improved now, as the whole import logic was rewritten
from scratch. from scratch.
Import is done completely offline and do not call the MusicBrainz API anymore, Import is done completely offline and no longer calls the MusicBrainz API,
except to retrieve covers if those are not embedded in the imported files. except to retrieve covers if those are not embedded in the imported files.
MusicBrainzare references are still stored in the database, but we rely solely MusicBrainz references are still stored in the database, but we rely solely
on the tags from the audio file now. on the tags from the audio file now.
This has two positive consequences: This has two positive consequences:
- Improved performance for both small and big imports (possibly by a factor 10) - Improved performance for both small and big imports (possibly by a factor of 10)
- More reliable import result: if your file is tagged in a specific way, we will only - More reliable import result: if your file is tagged in a specific way, we will only
use tags for the import. use tags for the import.
Imports from federation, command-line and UI/API all use the same code, Imports from federation, command-line and UI/API all use the same code,
which should greatly reduce the bugs/discrepencies. which should greatly reduce the bugs/discrepencies.
Finally, the import engine now understand the difference between a track artist Finally, the import engine now understands the difference between a track artist
and an album artist, which should put an end to the album splitting issues and an album artist, which should put an end to the album splitting issues
for tracks that had a different artist than the album artist. for tracks that had a different artist than the album artist.
@ -140,10 +140,10 @@ What will break
--------------- ---------------
If you've read until here, you can probably understand that all of these changes If you've read until here, you can probably understand that all of these changes
comes at a cost: version 0.17 contains breaking changes, feature were removed comes at a cost: version 0.17 contains breaking changes, removed features and other
or changed. changes.
Those features were removed: The following features were removed:
- YouTube imports: for copyright reasons, keeping this in the core was not possible - YouTube imports: for copyright reasons, keeping this in the core was not possible
- Music requests: those are now less useful since anyone can upload content - Music requests: those are now less useful since anyone can upload content
@ -171,13 +171,13 @@ bind content imported by each one to this library.
Libraries created this way will have a different visibility level depending of your instance configuration: Libraries created this way will have a different visibility level depending of your instance configuration:
- If your instance requires authentication to access the API / Listen to music, libraries will - If your instance requires authentication to access the API / listen to music, libraries will
be marked with "instance" visibility. As a result, all users from the instance will still be marked with "instance" visibility. As a result, all users from the instance will still
be able to listen to all the music of the instance after the migration be able to listen to all the music of the instance after the migration
- If your instance does not requires authentication to access the API / Listen to music, - If your instance does not require authentication to access the API / listen to music,
libraries will be completely public, allowing anyone to access the content (including federation) libraries will be completely public, allowing anyone to access the content (including federation)
This script will contain other database-related operations, but the impact will remain This script will also contain other database-related operations, but the impact will remain
invisible. invisible.
@ -199,7 +199,7 @@ On non docker-setups::
sudo -u funkwhale -H -E /srv/funkwhale/virtualenv/bin/python api/manage.py script create_actors --no-input sudo -u funkwhale -H -E /srv/funkwhale/virtualenv/bin/python api/manage.py script create_actors --no-input
sudo -u funkwhale -H -E /srv/funkwhale/virtualenv/bin/python api/manage.py script migrate_to_user_libraries --no-input sudo -u funkwhale -H -E /srv/funkwhale/virtualenv/bin/python api/manage.py script migrate_to_user_libraries --no-input
If the scripts ends without errors, you're instance should be updated and ready to use :) If the scripts complete without errors, your instance should be updated and ready to use :)
.. note:: .. note::

18
docs/installation/index.rst
View File

@ -47,7 +47,7 @@ Funkwhale packages are available for the following platforms:
- `YunoHost 3 <https://yunohost.org/>`_: https://github.com/YunoHost-Apps/funkwhale_ynh (kindly maintained by `@Jibec <https://github.com/Jibec>`_) - `YunoHost 3 <https://yunohost.org/>`_: https://github.com/YunoHost-Apps/funkwhale_ynh (kindly maintained by `@Jibec <https://github.com/Jibec>`_)
- ArchLinux (as an AUR package): if you'd rather use a package, check out this alternative installation method on ArchLinux: https://wiki.archlinux.org/index.php/Funkwhale (package and wiki kindly maintained by getzee) - ArchLinux (as an AUR package): if you'd rather use a package, check out this alternative installation method on ArchLinux: https://wiki.archlinux.org/index.php/Funkwhale (package and wiki kindly maintained by getzee)
- `NixOS <https://github.com/mmai/funkwhale-nixos>`_ (kindly maintained by @mmai) - `NixOS <https://github.com/mmai/funkwhale-nixos>`_ (kindly maintained by @mmai)
- `Helm chart <https://gitlab.com/ananace/charts/>`_ to install Funkwhale on Kubenertes (kindly maintained by @ananace) - `Helm chart <https://gitlab.com/ananace/charts/>`_ to install Funkwhale on Kubernetes (kindly maintained by `@ananace <https://gitlab.com/ananace>`_)
Project architecture Project architecture
-------------------- --------------------
@ -109,23 +109,23 @@ Running Funkwhale on the develop branch
--------------------------------------- ---------------------------------------
Traditional deployments are done using tagged releases. However, you Traditional deployments are done using tagged releases. However, you
may want to benefits from the latest change available, or the help detect may want to benefit from the latest changes available, or to help detect
bugs before they are included in actual releases. bugs before they are included in actual releases.
To do that, you'll need to run your instance on the develop branch, To do that, you'll need to run your instance on the develop branch,
which contains all the unreleased changes and features of the next version. which contains all the unreleased changes and features of the next version.
Please take into account that the develop branch Please take into account that the develop branch
may be unstable and will contain bugs that may affect the well being of your may be unstable and will contain bugs that may affect the well-being of your
instance. If you are comfortable with that, you need to backup at least your database instance. If you are comfortable with that, you need to backup at least your database
before pulling latest changes from the develop branch. before pulling the latest changes from the develop branch.
Otherwise, the deployment process is similar to deploying with releases. Otherwise, the deployment process is similar to deploying with releases.
You simply need to use ``export FUNKWHALE_VERSION=develop`` You simply need to use ``export FUNKWHALE_VERSION=develop``
in the installation and upgrade process instead of a real version number, in the installation and upgrade process instead of a real version number,
as we build artifacts on the development branch the same way we do for releases. as we build artifacts on the development branch the same way we do for releases.
It's also recommended to check out the `develop release notes <https://dev.funkwhale.audio/funkwhale/funkwhale/blob/develop/changes/notes.rst>_` before upgrading, It's also recommended to check out the `develop release notes <https://dev.funkwhale.audio/funkwhale/funkwhale/blob/develop/changes/notes.rst>`_ before upgrading,
since you may have to apply manual actions for your instance to continue to work. Such actions are labelled with ``[manual action required]`` in the releases notes. since you may have to apply manual actions for your instance to continue to work. Such actions are labelled with ``[manual action required]`` in the releases notes.
.. _frontend-setup: .. _frontend-setup:
@ -216,7 +216,7 @@ On non-docker deployments, run the following commands:
.. note:: .. note::
The resulting file should not contain any variable such as ``${FUNKWHALE_HOSTNAME}``. The resulting file should not contain any variables such as ``${FUNKWHALE_HOSTNAME}``.
You can check that using this command:: You can check that using this command::
grep '${' /etc/nginx/sites-available/funkwhale.conf grep '${' /etc/nginx/sites-available/funkwhale.conf
@ -285,7 +285,7 @@ Add the following to your ``.env`` file::
REVERSE_PROXY_TYPE=apache2 REVERSE_PROXY_TYPE=apache2
Then restart Funkwhale. This is needed to ensure Funkwhale provide proper headers for media file serving. Then restart Funkwhale. This is needed to ensure Funkwhale provides proper headers for media file serving.
Then, download our sample virtualhost file: Then, download our sample virtualhost file:
@ -295,7 +295,7 @@ Then, download our sample virtualhost file:
ln -s /etc/apache2/sites-available/funkwhale.conf /etc/apache2/sites-enabled/ ln -s /etc/apache2/sites-available/funkwhale.conf /etc/apache2/sites-enabled/
You can tweak the configuration file according to your setup, especially the You can tweak the configuration file according to your setup, especially the
TLS configuration. Otherwise, defaults, should work if you followed the TLS configuration. Otherwise, defaults should work if you followed the
installation guide. installation guide.
.. note:: .. note::
@ -340,5 +340,5 @@ to the file to serve to the user, and will be picked by nginx, but never sent
back to the client. back to the client.
Using this technique, we can ensure music files are covered by the authentication Using this technique, we can ensure music files are covered by the authentication
and permission policy of your instance, while keeping as much as performance and permission policy of your instance, while remaining as performant
as possible. as possible.

2
docs/users/apps.rst
View File

@ -187,7 +187,7 @@ Mobydick (Desktop)
^^^^^^^^^^^^^^^^^^ ^^^^^^^^^^^^^^^^^^
- Price: free - Price: free
- Website: https://github.com/BaptisteGelez/mobydick - Website: https://github.com/AnaGelez/mobydick
Mobydick is a free and open-source desktop application for linux (based on GTK+) to easily download Mobydick is a free and open-source desktop application for linux (based on GTK+) to easily download
tracks, albums and discography from a Funkwhale instance. tracks, albums and discography from a Funkwhale instance.