Merge branch '432-release-notes-docs' into 'develop'
Fix #432: release notes and documentation for tags Closes #432 See merge request funkwhale/funkwhale!839
This commit is contained in:
Eliot Berriot
commit
4d74a891dc
|
|
@ -0,0 +1 @@
|
||||||
|
Support for genres, via tags (#432)
|
||||||
|
|
@ -7,6 +7,33 @@ Next release notes
|
||||||
after each release.
|
after each release.
|
||||||
|
|
||||||
|
|
||||||
|
Support for genres via tags
|
||||||
|
^^^^^^^^^^^^^^^^^^^^^^^^^^^
|
||||||
|
|
||||||
|
One of our most requested missing features is now available!
|
||||||
|
|
||||||
|
Starting with Funkwhale 0.20,
|
||||||
|
Funkwhale will automatically extract genre information from uploaded files and associate it
|
||||||
|
with the corresponding tracks in the form of tags (similar to Mastodon or Twitter hashtags).
|
||||||
|
Please refer to `our tagging documentation <https://docs.funkwhale.audio/users/upload.html#tagging-files>`_
|
||||||
|
for more information regarding the tagging process.
|
||||||
|
|
||||||
|
Tags can also be associated with artists and albums, and updated after upload through the UI using
|
||||||
|
the edit system released in Funkwhale 0.19. Tags are also fetched when retrieving content
|
||||||
|
via federation.
|
||||||
|
|
||||||
|
Tags are used in various places to enhance user experience:
|
||||||
|
|
||||||
|
- Tags are listed on tracks, albums and artist profiles
|
||||||
|
- Each tag has a dedicated page were you can browse corresponding content and quickly start a radio
|
||||||
|
- The custom radio builder now supports using tags
|
||||||
|
- Subsonic apps that support genres - such as DSub or Ultrasonic - should display this information as well
|
||||||
|
|
||||||
|
If you are a pod admin and want to extract tags from already uploaded content, you run `this snippet <https://dev.funkwhale.audio/funkwhale/funkwhale/snippets/43>`_
|
||||||
|
and `this snippet <https://dev.funkwhale.audio/funkwhale/funkwhale/snippets/44>`_ in a ``python manage.py shell``.
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
Allow-list to restrict federation to trusted domains
|
Allow-list to restrict federation to trusted domains
|
||||||
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
|
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -74,16 +74,19 @@ However, Funkwhale can understand and use additional tags to enhance user experi
|
||||||
| ``Title`` (required) | ``Letting you`` | The track title |
|
| ``Title`` (required) | ``Letting you`` | The track title |
|
||||||
| | | |
|
| | | |
|
||||||
+----------------------------------+--------------------------------------------+---------------------------------------------------------------+
|
+----------------------------------+--------------------------------------------+---------------------------------------------------------------+
|
||||||
| ``Album`` (required) | ``The Slip`` | The album title |
|
|
||||||
| | | |
|
|
||||||
+----------------------------------+--------------------------------------------+---------------------------------------------------------------+
|
|
||||||
| ``Artist`` (required) | ``Nine Inch Nails`` | The artist name |
|
| ``Artist`` (required) | ``Nine Inch Nails`` | The artist name |
|
||||||
| | | |
|
| | | |
|
||||||
+----------------------------------+--------------------------------------------+---------------------------------------------------------------+
|
+----------------------------------+--------------------------------------------+---------------------------------------------------------------+
|
||||||
|
| ``Album`` | ``The Slip`` | The album title. If none is provided, an [Unknown Album] |
|
||||||
|
| | | entry will be created |
|
||||||
|
+----------------------------------+--------------------------------------------+---------------------------------------------------------------+
|
||||||
| ``Album artist`` | ``Trent Reznor`` | The album artist name (can be different than the track |
|
| ``Album artist`` | ``Trent Reznor`` | The album artist name (can be different than the track |
|
||||||
| | | artist) |
|
| | | artist) |
|
||||||
| | | |
|
| | | |
|
||||||
+----------------------------------+--------------------------------------------+---------------------------------------------------------------+
|
+----------------------------------+--------------------------------------------+---------------------------------------------------------------+
|
||||||
|
| ``Genre`` | ``Industrial, Metal`` | A comma separated list of tags to associate with the track |
|
||||||
|
| | | Other supported separators: ``;`` and ``/`` |
|
||||||
|
+----------------------------------+--------------------------------------------+---------------------------------------------------------------+
|
||||||
| ``Track number`` | ``4`` | The position of the track in the album/release |
|
| ``Track number`` | ``4`` | The position of the track in the album/release |
|
||||||
| | | |
|
| | | |
|
||||||
+----------------------------------+--------------------------------------------+---------------------------------------------------------------+
|
+----------------------------------+--------------------------------------------+---------------------------------------------------------------+
|
||||||
|
|
|
||||||
Loading…
Reference in New Issue