]> git.immae.eu Git - github/Chocobozzz/PeerTube.git/blobdiff - CHANGELOG.md
Bumped to version v5.2.1
[github/Chocobozzz/PeerTube.git] / CHANGELOG.md
index fec8926f9847c80087c3012bb117d938905f14fb..e2be0f5e2fcf417a11c7bd88673d69c938ffc0af 100644 (file)
@@ -1,5 +1,864 @@
 # Changelog
 
+## v5.2.1
+
+### Bug fixes
+
+ * Fix loading spinner displayed forever on Chrome
+ * Fix broken replay with long live name
+ * Fix fps transcoding on remote runners
+ * Fix terms/code of conduct link toggle
+
+
+## v5.2.0
+
+### IMPORTANT NOTES
+
+  * **Important** Remove NodeJS 14 support
+  * **Important** You must update your nginx configuration to support remote runners: https://github.com/Chocobozzz/PeerTube/blob/develop/support/nginx/peertube#L101
+  * Add `storage.tmp_persistent` directory in configuration file. **You must configure it in your production.yaml**: https://github.com/Chocobozzz/PeerTube/blob/develop/config/production.yaml.example#L128
+  * PeerTube requires **Docker Compose >= v2** for Docker compose installation
+
+### Maintenance
+
+  * Remove `npm run create-transcoding-job` and `npm run print-transcode-command` unmaintained scripts
+  * Add Redis sentinel support [#5593](https://github.com/Chocobozzz/PeerTube/pull/5593)
+  * Improve upgrade script (used when you will upgrade from PeerTube 5.2 to its next version) for classic installation:
+    * Automatically generate a `config/production.yaml.new` file after the upgrade, which is the fusion between the new PeerTube configuration keys and your current `production.yaml`. After a review you can replace your old `config/production.yaml` with this new file so you don't have to add new keys manually
+    * Add `ls` option compatibility with FreeBSD [#5785](https://github.com/Chocobozzz/PeerTube/pull/5785)
+
+### Docker
+
+  * Make database name configurable using env variable [#5734](https://github.com/Chocobozzz/PeerTube/pull/5734)
+
+### Plugins/Themes/Embed API
+
+  * Add `filter:html.client.json-ld.result` hook
+
+### Features
+
+  * :tada: Implement remote transcoding for VOD videos, Live streams and Studio editions :tada: [#5769](https://github.com/Chocobozzz/PeerTube/pull/5769)
+    * If enabled, remote PeerTube runners can process these high CPU jobs
+    * Admin documentation: https://docs.joinpeertube.org/admin/remote-runners
+    * PeerTube runner CLI documentation: https://docs.joinpeertube.org/maintain/tools#peertube-runner
+    * Demonstration video: https://peertube2.cpy.re/w/oJwHHYwt4oKjKhLNh2diAY
+    * Architecture documentation: https://docs.joinpeertube.org/contribute/architecture#remote-vod-live-transcoding
+  * Add Podcast RSS feed support: [#5487](https://github.com/Chocobozzz/PeerTube/pull/5487)
+  * Add ability to set custom privacy for live replays [#5692](https://github.com/Chocobozzz/PeerTube/pull/5692)
+  * Render images of markdown fields in *About* page [#5732](https://github.com/Chocobozzz/PeerTube/pull/5732)
+  * Admin can disable user video history by default [#5728](https://github.com/Chocobozzz/PeerTube/pull/5728)
+  * Improve global accessibility
+
+### Bug fixes
+
+  * Fix live stream object storage sync resulting in broken playback on iOS after a few minutes
+  * Correctly proxify HTTP 206 content-range header from object storage [#5703](https://github.com/Chocobozzz/PeerTube/pull/5703)
+  * Filter out already watched videos from recommended videos [#5739](https://github.com/Chocobozzz/PeerTube/pull/5739)
+  * Prevent exception when HTTP headers are already sent
+  * Fix remote instance following/followers links in about page
+  * Prevent error when updating a running live stream if the privacy hasn't changed
+  * Prevent crash on plugin websocket error
+  * Don't call `register`/`unregister` plugin API when installing/uninstalling plugins using `script/plugin` scripts (offline mode)
+  * Fix error on missing plugin CSS file at PeerTube startup [#5746](https://github.com/Chocobozzz/PeerTube/pull/5746)
+  * Prevent "invalid end watch section" server log warnings
+  * Support remote subscribe with a handle starting with a `@` character
+  * Actor preferred username (account/channel handle) is now case insensitive
+  * Fix RTL layout inconsistencies
+  * Prevent user video notification when the subscription is still in *Pending* state
+  * Correctly remove *Pending* subscription
+  * Fix PeerTube subtitles import
+  * Fix languages alphabetical order
+  * Fix registration notification error
+  * Correctly unload plugin paths
+  * Fix custom default route in instance logo link
+  * Fix video channels quick filter overflow
+
+
+## v5.1.0
+
+### IMPORTANT NOTES
+
+ * If your instance has signup enabled, user registration approval is automatically enabled by the default configuration of this release. You can change this setting in your `production.yaml` or in the configuration page in the web admin
+ * Update [web browsers support list](https://joinpeertube.org/faq#what-web-browsers-are-supported-by-peertube):
+   * Drop support of Safari 11 on iOS
+   * Drop support of Safari 11 on desktop
+   * Drop support of Firefox 68 on desktop
+ * Minimum recommended Redis version is 6.2. Version 6.0 should still work: see [this comment](https://github.com/Chocobozzz/PeerTube/issues/5659#issuecomment-1449607001) for more information
+ * Deprecate NodeJS 14: support will be removed in the next release (PeerTube 5.2)
+
+### Maintenance
+
+ * [PeerTube OpenTelemetry](https://docs.joinpeertube.org/maintain/observability)
+   * Add BitTorrent tracker metrics
+   * Add ability to disable HTTP request duration metrics (can have a high tag cardinality)
+ * Add `x-powered-by` HTTP header in PeerTube response. Can be disabled in PeerTube configuration
+
+### Docker
+
+ * Add env variables to configure object storage
+
+### Documentation
+
+  * PeerTube documentation website now uses VitePress: https://docs.joinpeertube.org
+  * Add *Server code* documentation explaining the database model typing and how to add a new feature in PeerTube server: https://docs.joinpeertube.org/support/doc/development/server
+
+### Plugins/Themes/Embed API
+
+ * Add ability to set `playbackRate` in URL (watch page and embed) [#5486](https://github.com/Chocobozzz/PeerTube/pull/5486)
+ * Auth plugins:
+   * Can set default `adminFlags`, `videoQuota` and `videoQuotaDaily` user attributes
+   * Introduce `userUpdater` hook function so external auth plugins can update the user on user login: https://docs.joinpeertube.org/contribute/plugins#add-external-auth-methods
+   * Automatically redirect to the default external auth on PeerTube refresh token expiration
+ * Server plugin hooks (https://docs.joinpeertube.org/api/plugins):
+    * Add `filter:api.user.me.subscription-videos.list.params` & `filter:api.user.me.subscription-videos.list.result` [#5648](https://github.com/Chocobozzz/PeerTube/pull/5648)
+    * Add `filter:activity-pub.activity.context.build.result` to update ActivityPub JSON-LD context
+    * Add `filter:activity-pub.video.json-ld.build.result` to update `Video` ActivityPub JSON-LD object
+    * Add `action:activity-pub.remote-video.created` & `action:activity-pub.remote-video.updated` to react on remote video creation/update
+  * Client plugin hooks (https://docs.joinpeertube.org/api/plugins):
+    * Add `action:video-edit.form.updated` fired every time the video upload/import/live/update form values change
+    * Add `filter:video-watch.video-plugin-metadata.result` to add custom video metadata in watch page
+    * Existing `action:video-edit.init` hook now contains a `updateForm` attribute in options that you can use to update video upload/import/live/update form values
+ * Add server plugin helpers:
+   * `getServerListeningConfig` to get PeerTube listening configuration
+ * Convert some colors to PeerTube CSS variables to improve theme compatibility
+
+### Features
+
+ * :tada: Implement user registration approval (https://docs.joinpeertube.org/admin/managing-users#registration-approval) [#5544](https://github.com/Chocobozzz/PeerTube/pull/5544)
+   * If enabled, the user has to fill a *Registration reason* input
+   * Moderators have to to accept/reject the registration with a *Moderation response* that will be sent by email to the user
+   * If the registration is accepted, the user and its channel are automatically created
+ * Add "back to live" button in player
+   * The *Live* button is red when the player is synced with the live
+   * It becomes grey when behind the live edge
+   * Clicking on the grey button re-sync the player with the live edge
+ * Add Icelandic & Ukrainian locales
+ * Add *Global views* default trending algorithm option in admin configuration [#5471](https://github.com/Chocobozzz/PeerTube/pull/5471)
+ * Performance:
+   * Blocked IPs by the tracker are now stored in NodeJS memory instead of Redis, reducing PeerTube load
+   * Optimize video comments SQL requests
+   * Optimize custom markup live rendering in admin
+  * UI/UX:
+    * Add option in video/playlist share modal to create a responsive embed [#5690](https://github.com/Chocobozzz/PeerTube/pull/5690)
+    * Use `99+` instead of `99` when having more than `99` notifications
+    * Use channel display name instead of channel handle in *My videos* input filter [#5575](https://github.com/Chocobozzz/PeerTube/pull/5575)
+    * Display channel name in playlist element instead of account name
+    * Display channel as author in RSS feeds
+    * Improve/fix main pages keyboard navigation
+  * Custom markup:
+    * Support `mailto` links
+    * Support short UUID to fetch a video
+  * Admins can customize access and refresh tokens lifetime
+
+
+### Bug fixes
+
+ * Fix object storage incompatibility with some S3 providers that don't support ACL
+ * Fix signup limit
+ * Prevent `500` on invalid short UUID parameter
+ * Player:
+   * Fix live buffering with small latency setting
+   * More robust player "stats for nerds" popup if there is not stream available
+   * Don't display playback rate setting for lives
+   * Don't handle playback rate hotkeys for lives
+   * Fix clicking on PeerTube instance button
+   * Fix always resuming the end of the video
+   * Fix saving last video current time for anonymous users
+   * Fix player keyboard shortcuts for non latin keyboards [#5684](https://github.com/Chocobozzz/PeerTube/pull/5684)
+ * Process videos list requests in correct order
+ * Correctly fill the *Support* field when updating a video
+ * Fix *Auto play video* setting for anonymous users
+ * UI:
+   * Fix table columns max width
+   * Use *Unknown* instead of *Misc* when the video category is not set
+   * Prevent layout shift when listing videos
+   * Fix instance stats anchor link
+   * Fix menu content overlay on tablets
+   * Fix button overflows
+   * Handle `502` HTTP errors in client notifier
+   * Fix resetting chart zoom in video stats page
+   * Fix search page not loading all available results
+   * Fix confirmation modal that contains 2 text inputs
+ * Display the update button when the stable release of beta/alpha plugin is available
+ * Always list NSFW videos in playlists (the frontend is in charge to blur the video element if the NSFW setting is *Hide* or *Blur*)
+ * Always list NSFW videos in admin
+ * Improve client log report:
+   * Don't send client error on 404
+   * Prevent sending invalid error/warn logs coming from HLS player [#5484](https://github.com/Chocobozzz/PeerTube/pull/5484)
+ * Fix out of sync audio when cutting a video in Studio
+ * Fix "unique viewers" inconsistency with countries
+ * Fix mention detection in comments
+ * Fix listing all my channels in *My library*
+ * Fix displaying remote avatars
+ * Fix 404 HTTP code in watch page when having `;threadId` param in URL
+ * Correctly re-inject video file token in `.m3u8` resolution playlists to fetch private mp4 video file [#5677](https://github.com/Chocobozzz/PeerTube/pull/5677)
+ * Don't process live when moving videos to external storage
+ * Handle Redis disconnection gracefully [#5599](https://github.com/Chocobozzz/PeerTube/pull/5599)
+
+
+## v5.0.1
+
+### IMPORTANT NOTES
+
+ * If you upgrade from PeerTube **< 5.0.0**, please follow 5.0.0 IMPORTANT NOTES
+
+### Bug fixes
+
+ * Fix HLS player infinite loading when the live stream/video ends
+ * Do not autoplay live without autoplay setting
+ * Fix private/internal video playback from Cloudflare object storage
+ * Fix local channel stats/OpenTelemetry metric
+ * Also display dropdown for videos from the homepage
+ * Fix broken P2P with live stream coming from object storage
+ * Fix responsive of table pagination
+
+
+## v5.0.0
+
+### IMPORTANT NOTES
+
+ * **Important** Private and internal video files are now protected. See [#5370](https://github.com/Chocobozzz/PeerTube/pull/5370) for more information, but see below for most important information:
+   * For private/internal videos on filesystem:
+     * These videos are now under a `private/` subdirectory in `videos/` and `streaming-playlists/` directories
+     * Nginx doesn't serve these private files anymore, the requests are forwarded to PeerTube that will check authentication
+   * For private/internal videos in object storage:
+     * These videos have now a private ACL
+     * PeerTube proxifies requests to private object storage (using pre-signed URLs is not possible as explained in [#5370](https://github.com/Chocobozzz/PeerTube/pull/5370))
+   * Torrent files and magnet URIs of private/internal videos don't contain a webseed URL anymore since they require authentication
+ * **Important** You need to manually execute a migration script after your upgrade to migrate private/internal video files:
+   * Classic installation: `cd /var/www/peertube/peertube-latest && sudo -u peertube NODE_CONFIG_DIR=/var/www/peertube/config NODE_ENV=production node dist/scripts/migrations/peertube-5.0.js`
+   * Docker installation: `cd /var/www/peertube-docker && docker-compose exec -u peertube peertube node dist/scripts/migrations/peertube-5.0.js`
+ * Configuration changes (`config/production.yaml`):
+   * There is a new `secrets.peertube` configuration:
+     * Classic install: fill it before running PeerTube v5: https://github.com/Chocobozzz/PeerTube/blob/v5.0.0/config/production.yaml.example#L14
+     * Docker install: fill it using an env variable before running the containers: https://github.com/Chocobozzz/PeerTube/blob/develop/support/docker/production/.env#L27
+   * `object_storage.upload_acl` is now a parent key that you must update: https://github.com/Chocobozzz/PeerTube/blob/v5.0.0/config/production.yaml.example#L153
+ * You must update your nginx configuration:
+   * We introduced a new `location` for plugin websocket routes: https://github.com/Chocobozzz/PeerTube/blob/v5.0.0/support/nginx/peertube#L135
+   * We introduced a new `location` for private videos files: https://github.com/Chocobozzz/PeerTube/blob/v5.0.0/support/nginx/peertube#L217
+
+### Documentation
+
+ * Add [Monitoring/Observability documentation](https://docs.joinpeertube.org/maintain/observability) using PeerTube OpenTelemetry feature
+
+### Maintenance
+
+ * REST API breaking change:
+    * `role` is now `role.id` and `roleLabel` is `role.label` in user response
+    * We now store the complete remote video description:
+      * Deprecate `description` in favour of `truncatedDescription` when listing videos
+      * Complete description is sent by the server in `description` when getting a specific video
+      * Deprecate `/api/v1/videos/:id/description` endpoint
+ * `search.disable_local_search` disables local search in client search bar only and doesn't disable it on server side anymore [#5411](https://github.com/Chocobozzz/PeerTube/pull/5411)
+
+### Plugins/Themes/Embed API
+
+  * Add server plugin hooks (https://docs.joinpeertube.org/api/plugins):
+    * `filter:activity-pub.remote-video-comment.create.accept.result`
+  * Add server plugin helpers
+    * `socket.sendNotification` and `socket.sendVideoLiveNewState` [#5239](https://github.com/Chocobozzz/PeerTube/pull/5239)
+  * Add ability for plugins to register a websocket route using `registerWebSocketRoute`
+  * Add client plugin hooks (https://docs.joinpeertube.org/api/plugins):
+    * `filter:internal.player.p2p-media-loader.options.result` [#5318](https://github.com/Chocobozzz/PeerTube/pull/5318)
+
+### CLI tools
+
+ * Add ability to install alpha/beta/rc plugin versions
+
+### Features
+
+ * :tada: Support object storage for live streams :tada:
+ * :tada: Support Two Factor authentication (OTP) :tada:
+ * UX:
+   * Add explanation on disk space used for user quota admin config [#5305](https://github.com/Chocobozzz/PeerTube/pull/5305)
+   * Display channel in my videos list
+   * Show which playlists videos are added to in my videos list
+   * Add *Channels* link in left menu
+   * Add `...` after the truncated video name in miniature
+   * Add object storage info badge in videos admin overview
+   * Add links to video files in videos admin overview
+   * Better indicate the live ended in embed by displaying a message and the live preview
+   * Force live autoplay by muting the video if necessary when the user was waiting for the live
+ * Handle network issues in video player [#5138](https://github.com/Chocobozzz/PeerTube/pull/5138)
+ * Cache chunks to upload in server to resume upload later [#5224](https://github.com/Chocobozzz/PeerTube/pull/5224)
+ * Add ability to serve custom static files under `/.well-known` URL path [#5214](https://github.com/Chocobozzz/PeerTube/pull/5214)
+ * Use account/channel avatar in account/channel RSS feeds [#5325](https://github.com/Chocobozzz/PeerTube/pull/5325)
+ * Add filter to sort videos by name [#5351](https://github.com/Chocobozzz/PeerTube/pull/5351)
+ * Add ability to configure OpenTelemetry Prometheus exporter listening hostname
+
+### Bug fixes
+
+ * Hide all user email block if we can't change it (remote auth for example)
+ * Display an error if trying to reset password of user configured to use a remote authentication
+ * Fix peers info width in live
+ * Fix video job error when video has been deleted
+ * Fix user channels list with increased max counter
+ * More robust channel/playlist import/sync
+ * Hide useless *Wait Transcoding* input for lives
+ * Fix responsive in account channels list
+ * Fix slow page response when listing many videos
+ * Reload data when deleting a blocked video
+ * Prevent error with metrics in HTTP player if no P2P info is available
+ * Fix playlist overflow in account channels page
+ * Fix invalid date display for jobs
+ * Fix conflict with player hotkeys and `alt + number` web browser hotkey
+ * Fix horizontal overflow on rtl languages
+ * Fix actor follow constraint error on remote videos when *Allow users to do remote URI/handle search* is disabled
+ * Fix running again transcoding on a video that doesn't contain audio or on a video that doesn't contain video
+ * Fix re-transcoding of video with odd resolution
+ * Fix embed API with playlists
+ * Fix not working P2P with permanent live
+ * Fix following/fetching remote Pleroma actor
+ * Prevent high Redis memory usage when having many jobs
+ * Fix overall viewers stats with start/end dates
+ * Remove limit of countries displayed in video/live stats
+
+
+## v4.3.1
+
+### IMPORTANT NOTES
+
+ * If you upgrade from PeerTube **< 4.3.0**, please follow 4.3.0 IMPORTANT NOTES
+
+### SECURITY
+
+ * Prevent XSS in sort select on pages that list videos. Thanks to Anthony Roth who reported the vulnerability!
+
+### Bug fixes
+
+ * Fix broken embed player on live reload
+ * Fix channel follow when manually approve instance followers is enabled
+ * Fix input with number overflow on small screen
+ * Fix moderation dropdown overflow on mobile
+ * Clearer instance subscription page title in admin
+ * Prevent "Cannot use same state" video error
+ * Correctly handle RTMP streams without audio
+ * Correctly process broadcast parallel job in parallel
+
+
+## v4.3.0
+
+### IMPORTANT NOTES
+
+ * Redis **<** 5.x is not supported anymore
+ * FFmpeg **<** 4.3 is not supported anymore
+
+### Maintenance
+
+ * Use `yt-dlp` by default instead of `youtube-dl` for new installations (because of much more dev activity)
+ * Support NodeJS 18
+ * Improved PeerTube logs:
+    * Reduce amount of PeerTube error logs
+    * Introduce `log.log_tracker_unknown_infohash` setting to disable "Unknown infoHash" warnings
+    * Web browsers send their error logs to the server that writes them in its own logs. Can be disabled by `log.accept_client_log` setting
+ * Introduce experimental support of [OpenTelemetry](https://opentelemetry.io/)
+   * Enable metrics export using a Prometheus exporter
+   * Enable tracing export using a Jaeger exporter
+ * Automatically rebuild native plugin modules on NodeJS ABI change
+
+### Docker
+
+ * Add ability to easily use the docker compose stack on localhost
+
+### Plugins/Themes/Embed API
+
+  * Theme:
+    * Removed unused `--secondaryColor` CSS variable
+  * Add client plugin hooks (https://docs.joinpeertube.org/api/plugins):
+    * `filter:api.my-library.video-playlist-elements.list.params` & `filter:api.my-library.video-playlist-elements.list.result` [#5098](https://github.com/Chocobozzz/PeerTube/pull/5098)
+    * `action:video-channel-create.init`
+    * `action:video-channel-update.init` & `action:video-channel-update.video-channel.loaded`
+    * `action:video-channel-videos.init` & `action:video-channel-videos.video-channel.loaded` & `action:video-channel-videos.videos.loaded`
+    * `action:video-channel-playlists.init` & `action:video-channel-playlists.video-channel.loaded` & `action:video-channel-playlists.playlists.loaded`
+    * `filter:share.video-embed-code.build.params` & `filter:share.video-embed-code.build.result` & `filter:share.video-playlist-embed-code.build.params` & `filter:share.video-playlist-embed-code.build.result`
+    * `filter:share.video-embed-url.build.params` & `filter:share.video-embed-url.build.result` & `filter:share.video-playlist-embed-url.build.params` & `filter:share.video-playlist-embed-url.build.result`
+    * `filter:share.video-url.build.params` & `filter:share.video-url.build.result` & `filter:share.video-playlist-url.build.params` & `filter:share.video-playlist-url.build.result`
+    * `action:modal.share.shown`
+  * Add server plugin hooks (https://docs.joinpeertube.org/api/plugins):
+    * `filter:job-queue.process.params` & `filter:job-queue.process.result`
+    * `filter:transcoding.manual.resolutions-to-transcode.result` & `filter:transcoding.auto.resolutions-to-transcode.result`
+    * `action:api.video-channel.created` & `action:api.video-channel.updated` & `action:api.video-channel.deleted`
+    * `action:notifier.notification.created`
+  * Add HTML placeholder (https://docs.joinpeertube.org/contribute/plugins#html-placeholder-elements):
+    * `share-modal-playlist-settings` & `share-modal-video-settings`
+
+### Features
+
+  * :tada: Add ability for users to synchronize a remote channel [#5135](https://github.com/Chocobozzz/PeerTube/pull/5135) :tada:
+    * Automatically import all videos of a remote channel in your PeerTube channel
+    * PeerTube will watch for new publications and automatically import these new videos
+  * UI:
+    * Redesigned *Create an account* steps
+    * Improved *Login* page
+    * Use a lighter font color
+    * Use a bigger font size
+    * Don't display form errors in red while typing but only when we unfocus the input
+    * Display an error message when the user is unauthorized to view a page [#5097](https://github.com/Chocobozzz/PeerTube/pull/5097)
+    * Display latest upload date for captions
+    * Add an information if the live will be saved as a replay when displaying live sessions
+    * Move search bar at the center of the header
+  * Add *Toki Pona* and *Croatian* locales in client
+  * Embed:
+    * Display a message and automatically start live streams in embed
+    * Use the instance name instead of "PeerTube" in embed control bar
+    * Reuse current watch page query parameters for embed when using OEmbed [#5023](https://github.com/Chocobozzz/PeerTube/pull/5023)
+  * Instance follows:
+    * Introduce a *Rejected* state for follow requests to not reprocess already rejected follow requests
+    * Add bulk actions on instance following/followers ()
+  * Admins:
+    * Add ability to disable original resolution transcoding of the uploaded video/live stream
+    * Add ability to delete a specific video file in videos overview
+    * Display *Last Login* column by default in users overview
+    * Remember last selected columns in users overview
+    * Add ability to set a custom video import timeout
+    * Add ability to set the default feed (Atom, RSS...) items count
+    * Admins and moderators now bypass API rate limits
+    * Add ability to list comments on local videos in comments overview
+  * Limit video import resolution depending on enabled VOD transcoding resolutions
+  * Store and display the uploaded video original filename [#4885](https://github.com/Chocobozzz/PeerTube/pull/4885)
+  * Add *Total views* in the my channels list [#5007](https://github.com/Chocobozzz/PeerTube/pull/5007)
+  * Add *Original Publication Date* video sort option [#4959](https://github.com/Chocobozzz/PeerTube/pull/4959)
+  * Performance:
+    * Optimized view/watching endpoint
+    * Optimized video feed SQL query
+    * Process images (resize, convert...) in a dedicated worker thread
+    * Optimized emoji markup list rendering in client
+    * Use a worker thread to send ActivityPub Broadcast requests
+  * Suffix external auth username/channel name on conflict instead of throwing an exception
+
+### Bug fixes
+
+  * Fix users overview *Last login* sort in admin
+  * More robust *move to object storage* job failure
+  * Fix comment add avatar with a unauthenticated user
+  * Fix fetching unlisted video in client
+  * Fix comments/download enabled attributes when importing a video
+  * Fix total instance views stats
+  * Fix HLS player infinite buffering on seek
+  * Reset table pagination on search
+  * *Host* search filter can also search into channels and playlists in global search
+  * Fix *My videos* invalid counter
+  * Prevent error on highlighted thread
+  * Fix *Jobs*, *Account blocklist* and *Server blocklist* hidden columns on Safari
+  * Fix live stream max bitrate
+  * Fix incompatibility with OpenSSL 3
+  * Don't crash on redis connection error
+  * Transcoding:
+    * Fix failed transcoding with a mp3 file that contains a cover image
+    * Prevent duplicated HLS playlist when running transcoding
+    * Regenerate video file names when running transcoding manually
+    * Prevent job failures resulting in broken videos on concurrent transcoding
+    * Fix transcoding of videos with quad audio channels
+  * ActivityPub
+    * Fix random invalid HTTP signature generation
+    * Use unique AP id for *Accept*/*Reject* activities
+    * Correctly handle remote actors that don't have follow counters
+    * Correctly handle unknown remote actor image size
+  * Add years in graph legend when grouping video views stats by month
+  * Prevent creating multiple lives when clicking multiple times on the "Go Live" button
+  * Fix *undefined" resolution in player *Stats for nerds*
+  * Fix not displayed error message in administrator web config
+  * More robust S3 upload [#5231](https://github.com/Chocobozzz/PeerTube/pull/5231)
+  * Fix broken saved live stream with only one resolution
+  * Fix `removeEventListener` player embed api
+  * Progressively cleanup actor images without width from the database
+  * Fix broken dates on localized pages
+  * Prevent job queue to be started before plugins
+  * Fix old database enum names
+  * Don't display remove file icon in admin videos overviews if we can't delete the file
+
+
+## v4.2.2
+
+### IMPORTANT NOTES
+
+ * If you upgrade from PeerTube **< 4.2.0**, please follow 4.2.0 IMPORTANT NOTES
+
+### SECURITY
+
+ * Upgrade vulnerable server dependencies
+
+### Bug fixes
+
+ * Fix fast restream in permanent live
+ * Fix latency mode setting when creating a live
+ * Fix unique constraint tag violation when importing videos
+ * Fix latest live sessions order
+ * Fix server crash feed when accessing feeds that contains a live
+ * Fix `false` boolean attribute (`data-is-live` etc) in custom markup
+
+
+## v4.2.1
+
+### IMPORTANT NOTES
+
+ * If you upgrade from PeerTube **< 4.2.0**, please follow 4.2.0 IMPORTANT NOTES
+
+### Bug fixes
+
+ * Fix live ending job that breaks new live session
+ * Fix search filters counter
+ * Fix upload banner icon margin
+ * Fix button icon margin
+ * Fix my import expander icon that should only be displayed on import error
+ * Fix select components styling inconsistency
+ * Increase max watch section to avoid too much warnings in server
+ * Optimize broadcast job creation
+ * Optimize `View` activities delivery using a dedicated broadcast job queue that can be run in parallel
+ * Fix video selection buttons placement
+ * Fix searching into account blocklist
+ * Fix incorrect instance stats
+ * Fix broken player on ICE error
+ * Relax views federation
+ * Fix peertube user in docker
+ * Fix playlist element federation with a deleted video
+
+
+## v4.2.0
+
+### IMPORTANT NOTES
+
+ * **Important** You need to execute manually a migration script (can be executed after your upgrade, while your PeerTube instance is running) to generate smaller avatar miniatures:
+   * Classic installation: `cd /var/www/peertube/peertube-latest && sudo -u peertube NODE_CONFIG_DIR=/var/www/peertube/config NODE_ENV=production node dist/scripts/migrations/peertube-4.2.js`
+   * Docker installation: `cd /var/www/peertube-docker && docker-compose exec -u peertube peertube node dist/scripts/migrations/peertube-4.2.js`
+ * **Important** SQL migrations (in particular `0685-multiple-actor-images`) can take several minutes to complete
+ * **Important** You must update your nginx configuration to support video web editor: https://docs.joinpeertube.org/install/any-os#nginx
+ * REST API:
+   * `PUT /api/v1/videos/{id}/watching` is deprecated, use `POST /api/v1/videos/videos/{id}/views` instead: https://docs.joinpeertube.org/api-rest-reference.html#operation/addView
+
+### Maintenance
+
+ * Add `client.videos.resumable_upload.max_chunk_size` config option [#4857](https://github.com/Chocobozzz/PeerTube/pull/4857)
+ * Add `object_storage.upload_acl` config option [#4861](https://github.com/Chocobozzz/PeerTube/pull/4861)
+ * Add ability to set RTMP/RTMPS listening hostname using `rtmp.hostname`/`rtmps.hostname` and public RTMP/RTMPS hostname using `rtmp.public_hostname`/`rtmps.public_hostname`
+ * Removed `best` default trending algorithm. It is automatically used if using `hot` algorithm with a logged in user
+
+### Docker
+
+ * Use NodeJS 16 in PeerTube docker image: administrators may have to reinstall PeerTube plugins that use native NodeJS dependencies
+ * Support readonly tmp directory (if you want to use `tmp` directory as a volume)
+
+### Plugins/Themes/Embed API
+
+ * Theme:
+   * Add `--mainBackgroundHoverColor` and `--greySecondaryBackgroundColor` CSS variables
+ * Add server plugin hooks
+   * `filter:api.video-playlist.videos.list.params` and `filter:api.video-playlist.videos.list.result`
+ * Support `getSettings()`, `isLoggedIn()` and `getAuthHeader()` client plugin helpers in embed
+ * Player URL query parameters:
+   * Support `controlBar=0` to hide player control bar. See [the documentation](https://docs.joinpeertube.org/api/embed-player#url-parameters) for more information
+
+### Features
+
+ * :tada: Add video edition from the PeerTube web interface :tada:
+   * Cut the video (set a new start/new end)
+   * Add an intro at the beginning and/or an outro at the end of the video
+   * Add an icon/watermark in the top right corner of the video
+   * PeerTube will automatically transcode the new video and replace the original one
+   * :sparkles: *Funded by "la Direction du numérique du Ministère de l'Éducation Nationale, de la Jeunesse et des Sports"* :sparkles:
+ * :tada: Add advanced statistics of a specific video :tada:
+   * Provide *Average watch time*, *Total watch time* and *Peak viewers* video statistics
+   * Display total viewers, aggregated watch time and audience retention in interactive time series graphs
+   * Display viewer countries in bar chart if not disabled by admins
+   * :sparkles: *Funded by HowlRound Theatre Commons at Emerson College* :sparkles:
+ * :tada: Add latency setting support for lives (small latency without P2P or high latency to increase P2P ratio) :tada:
+ * :tada: Add ability to save a replay of every streaming session of a permanent live :tada:
+   * :sparkles: *Funded by HowlRound Theatre Commons at Emerson College* :sparkles:
+ * Add simple subtitle edition from video captions tab in video edition form [#4666](https://github.com/Chocobozzz/PeerTube/pull/4666)
+ * Display live streaming sessions details in permanent live information modal
+ * Add ability to also mute users when banning them [#4660](https://github.com/Chocobozzz/PeerTube/pull/4660)
+ * UI improvements:
+   * Add ability for admins to display author avatar in video miniatures [#4639](https://github.com/Chocobozzz/PeerTube/pull/4639) [#4823](https://github.com/Chocobozzz/PeerTube/pull/4823)
+   * Display author avatar in embed
+   * Move admin comments list in *Overviews* menu
+   * Add a *Refresh* button to admin comments list
+   * Add ability to sort videos by total views
+ * Add *Persian* locale support
+ * Add previous page redirection support on external auth login
+ * Support proxy for object storage [#4973](https://github.com/Chocobozzz/PeerTube/pull/4973)
+ * Add "Only display embed URL" checkbox in share modal
+
+### Bug fixes
+
+ * Video uploads fixes:
+    * Fix invalid token during long uploads
+    * Fix upload on server with a slow disk
+    * Fix upload of some videos with unknown duration (`.m2v` for example)
+    * Fix 2 hours limit on uploads
+    * Fix upload page title [#4904](https://github.com/Chocobozzz/PeerTube/pull/4904)
+    * Fix video upload with some characters in filename
+    * Fix `.ac3` and `.mts` upload on some OS
+ * Fix avatar with account username starting with a number
+ * Fix client html cache on theme update
+ * Disallow unlisted video indexation
+ * Allow oembed to fetch unlisted videos
+ * Stop removing remote Mastodon rates
+ * Fix email links displayed twice in text version
+ * Fix user quota inconsistencies in admin when users use lives
+ * Fix admin instance following list when sorting by *Redundancy allowed*
+ * More reliable object storage upload when using multipart [#4903](https://github.com/Chocobozzz/PeerTube/pull/4903)
+ * Correctly handle HTTP signature draft 11 requests (without `date` header but with `(created)`)
+ * Fix `ctrl + 0-9` player hotkeys conflicting with web browser hotkeys
+
+
+## v4.1.1
+
+### Security
+
+ * Strip EXIF data when processing images
+
+### Docker
+
+ * Fix videos import by installing python 3
+ * Install `git` package (may be needed to install some plugins)
+
+### Bug fixes
+
+ * Fix error when updating a live
+ * Fix performance regression when rendering HTML and feeds
+ * Fix player stuck by HTTP request error
+
+
+## v4.1.0
+
+### IMPORTANT NOTES
+
+ * PeerTube does not support NodeJS 12 anymore
+
+### Plugins/Themes/Embed API
+
+ * Introduce ability for plugins to create client pages: https://docs.joinpeertube.org/contribute/plugins#create-client-page
+ * Plugins that register custom video fields can choose in which tab they want to display them and can report errors: https://docs.joinpeertube.org/contribute/plugins#add-custom-fields-to-video-form
+ * Add new client plugin id selectors
+   * Add `#plugin-selector-about-instance-moderation`, `#plugin-selector-about-instance-other-information`, `#plugin-selector-about-instance-features`, `#plugin-selector-about-instance-statistics`, `#plugin-selector-about-menu-instance`, `#plugin-selector-about-menu-peertube`, `#plugin-selector-about-menu-network` in about page [#4597](https://github.com/Chocobozzz/PeerTube/pull/4597)
+   * Add `#plugin-selector-menu-user-dropdown-language-item` in menu [#4597](https://github.com/Chocobozzz/PeerTube/pull/4597)
+ * Add client plugin hooks
+   * `filter:login.instance-about-plugin-panels.create.result` and `filter:signup.instance-about-plugin-panels.create.result` to add custom instance information in login/signup pages
+ * Add server plugin hooks
+   * `filter:api.server.stats.get.result`
+   * `filter:api.video.upload.video-attribute.result`, `filter:api.video.import-url.video-attribute.result`, `filter:api.video.import-torrent.video-attribute.result`, `filter:api.video.live.video-attribute.result` when creating a video object
+   * `action:api.video-caption.created` and `action:api.video-caption.deleted` [#4650](https://github.com/Chocobozzz/PeerTube/pull/4650)
+ * Server helpers
+   * `videos.getFiles(videoId: number)` to list video files (webtorrent, hls and thumbnail files)
+   * `videos.ffprobe(path: string)` to get `ffprobe` JSON result
+ * Publish [@peertube/peertube-type](https://www.npmjs.com/package/@peertube/peertube-types) NPM module that can be used by TypeScript plugins
+ * Add ability to disable P2P in embed using `p2p` query parameter in embed URL
+
+### Maintenance
+
+ * REST API
+   * Deprecate `webTorrentEnabled` in favour of `p2pEnabled` for user model
+   * Add ability to pause/resume the job queue
+ * Also publish stable releases on https://builds.joinpeertube.org/release
+ * Add ability for admins to specify `youtube-dl`/`yt-dlp` python binary path [#4706](https://github.com/Chocobozzz/PeerTube/pull/4706)
+ * PeerTube server startup is faster
+
+### Security
+
+  * Check video privacy before listing or accepting captions, comments or rates
+  * Check video import target URL does not resolve to internal IP. This technique has some limits so if you have private HTTP services on your server/network publicly accessible, we recommend to use a proxy or a dedicated interface for PeerTube
+
+### CLI tools
+
+ * Also remove HLS files when using `prune-storage` script
+ * Support `--plugin-version` option when installing a plugin [#4599](https://github.com/Chocobozzz/PeerTube/pull/4599)
+
+### Features
+
+ * :tada: Player improvements
+   * Increase control bar size on desktop & mobile
+   * Add overlay on tap to easily play/pause the video on mobile
+   * Automatically move to landscape when full screen a video on mobile
+   * Add fast forward/rewind on double tap on mobile
+   * Cleanup, fix and add player hotkeys
+   * Keep control bar displayed when settings panel is opened
+   * Faster hiding transition for control bar
+   * Stop confusing *peer* indication in control bar when p2p is disabled
+   * Try to fast forward video on HLS decode error
+ * :tada: More admin customizations
+   * Specify default *Publish* video attributes (download enabled, comments enabled, privacy, licence)
+   * Choose to automatically redirect users on the external auth platform on login button click
+   * Set default P2P policy for the player
+ * Search improvements
+   * Add *Result type* filter in search (videos, channels or playlists)
+   * Display only video results when searching on video metadata (tags, categories etc)
+ * Video imports
+   * Users can cancel and delete video imports
+   * Add ability to filter video imports by target URL
+ * Add ability for users to delete individual elements in videos history
+ * Show date and views counter in playlist element miniature [#4396](https://github.com/Chocobozzz/PeerTube/issues/4396)
+ * Add *norsk* locale support
+ * Check mute status and display mute badges in channel and account pages
+ * Add *No linguistic content* video language option [#4631](https://github.com/Chocobozzz/PeerTube/pull/4631)
+ * Don't send notifications to admins/moderators if an admin/moderator reported an abuse
+ * Add ability for moderators/admins to edit any channel [#4608](https://github.com/Chocobozzz/PeerTube/pull/4608)
+ * Add a refresh button to admin videos overview page [#4753](https://github.com/Chocobozzz/PeerTube/pull/4753)
+ * Add *Official* badge to official plugins in admin plugin pages
+ * Automatically clean unavailable remote ActivityPub resources
+ * Media RSS feed displays video file as default enclosure instead of torrent
+ * Use white background for PeerTube icons (instead of transparency)
+ * Show private badge for private videos in playlists [#4767](https://github.com/Chocobozzz/PeerTube/pull/4767)
+
+### Bug fixes
+
+ * Fix weird `require` bug on plugin upgrade
+ * Fix plugin storage return value when storing a JSON array [#4640](https://github.com/Chocobozzz/PeerTube/pull/4640)
+ * Decrease delay to cleanup resumable uploads (to 1 hour)
+ * Update torrent metadata on video update
+ * Fix HLS player with videos that have stream duration inconsistencies
+ * Fix player crash if the video contains only audio resolution
+ * Fix ffmpeg crash when using a transcoding plugin encoder that doesn't support PeerTube B-frame strategy
+ * Fix transcoding failure for audio only uploads
+ * Don't run HLS transcoding when running manually WebTorrent transcoding from the admin
+ * Don't run audio transcoding with video only file
+ * Correctly send new HLS files after re-transcoding to object storage
+ * Fix stuck state when move transcoding job failed
+ * Correctly display internal videos of internal subscriptions
+ * Correctly display all videos history to users
+ * Fix video upload with big preview file
+ * Fix description/comment timestamp click of external video
+ * Add missing `mediaType` information to AP objects
+ * Fix abuse list crash on deleted reporter account
+ * Convert markdown to HTML/plain text for RSS feeds
+ * Search on tags is now case insensitive
+ * Forbid comments/captions listing of private/internal videos
+ * Prevent video import on non unicast ips
+ * Improve markdown to plain text converter, especially when handling lists
+ * Fix scheduled publication on upload
+ * Fix youtube-dl max buffer size error
+ * Hide remote subscribe if user is logged in
+ * Fix video file `storage` column inconsistency
+
+
+## v4.0.0
+
+### IMPORTANT NOTES
+
+ * **Important** You need to execute manually a migration script (can be executed after your upgrade, while your PeerTube instance is running) to migrate HLS files name:
+   * Classic installation: `cd /var/www/peertube/peertube-latest && sudo -u peertube NODE_CONFIG_DIR=/var/www/peertube/config NODE_ENV=production node dist/scripts/migrations/peertube-4.0.js`
+   * Docker installation: `cd /var/www/peertube-docker && docker-compose exec -u peertube peertube node dist/scripts/migrations/peertube-4.0.js`
+ * **Important** We fixed configuration inconsistencies and added some keys. **You must change/add them in your production.yaml**
+   * `log.rotation.maxFileSize` becomes `log.rotation.max_file_size`
+   * `log.rotation.maxFiles` becomes `log.rotation.max_files`
+   * `log.anonymizeIP` becomes `log.anonymize_ip`
+   * Removed `import.http.proxy` configuration: use `HTTP_PROXY` and `HTTPS_PROXY` environment variables instead
+   * Added `storage.bin` in configuration file
+ * REST API: Deprecate `filter` videos list query parameter in favour of `isLocal` and `include`
+ * PeerTube **is compatible** with ffmpeg 4.4.1 but **is not compatible** with ffmpeg 4.4.0
+ * Removed deprecated `/static/torrents` route
+ * We changed the live `views` and `viewers` system, that could lead to federation inconsistencies with instances < 4.0.0 for these specific counters
+
+### Maintenance
+
+ * Add ability for sysadmins to disable web configuration edition [#4315](https://github.com/Chocobozzz/PeerTube/pull/4315)
+ * YoutubeDL:
+   * Support [yt-dlp](https://github.com/yt-dlp/yt-dlp/) (recommended due to unmaintained [youtube-dl](https://github.com/ytdl-org/youtube-dl))
+   * Add ability to set release URL in configuration
+ * Add ability to override `default-playlist.png`, `default-avatar-account.png`, `default-avatar-video-channel.png` using `storage.client_overrides` configuration [#4392](https://github.com/Chocobozzz/PeerTube/pull/4392)
+
+### Plugins/Themes/Embed API
+
+*Documentation: https://docs.joinpeertube.org/api/plugins*
+
+ * Add client plugin hooks:
+   * `filter:api.video-watch.video-playlist-elements.get.params` and `filter:api.video-watch.video-playlist-elements.get.result` [#4387](https://github.com/Chocobozzz/PeerTube/pull/4387)
+ * Introduce plugin id selectors: https://docs.joinpeertube.org/contribute/plugins#plugin-selector-on-html-elements
+   * Add `#plugin-selector-login-form` to login form
+
+### Docker
+
+ * We now use Bullseye for Docker images, so the image name changed:
+   * `production-buster` becomes `production-bullseye`
+   * `v4.x.x-buster` becomes `v4.x.x-bullseye`
+ * Allow configuration to be static/readonly [#4315](https://github.com/Chocobozzz/PeerTube/pull/4315)
+
+### CLI tools
+
+ * Add [create-move-video-storage-jobs](https://docs.joinpeertube.org/maintain/tools#create-move-video-storage-jobjs) script to move local video files in object storage [#4481](https://github.com/Chocobozzz/PeerTube/pull/4481)
+ * Removed `peertube-repl` and `peertube-watch` scripts
+ * Apply import interval only when reasonable [#4552](https://github.com/Chocobozzz/PeerTube/pull/4552)
+
+### Features
+
+ * :tada: Add videos overview in admin
+   * List all available videos on the instance
+   * Display video information summary: file type, file size, privacy, state, embed...
+   * Many filters available: videos with/without HLS/WebTorrent, remote/local videos, exclude muted accounts...
+   * Run WebTorrent/HLS transcoding
+   * Remove WebTorrent/HLS video files
+   * Bulk actions: remove, block, run transcoding, delete video files...
+ * Correctly generate thumbnails/previews for portrait videos
+ * Keep input image ratio for banners, avatars, thumbnails...
+ * Support 144p transcoding [#4492](https://github.com/Chocobozzz/PeerTube/pull/4492)
+ * Support RTMPS
+ * UI:
+   * Live:
+      * Specify live type at first step
+      * Improve *Permanent live* label using *Recurring live* expression
+    * Clearer moderation dropdowns using section titles
+    * Improve admin tables responsive
+    * Add warning when trying to share a private playlist/video [#4469](https://github.com/Chocobozzz/PeerTube/pull/4469)
+    * Change *Sort by views* to *Sort by recent views* [#4483](https://github.com/Chocobozzz/PeerTube/pull/4483)
+    * Add *Next video to be played* in watch page if autoplay is enabled [#4497](https://github.com/Chocobozzz/PeerTube/pull/4497)
+    * Add embed preview in share modal
+    * Add user username in modal when deleting a user
+    * Add video name in modal when blocking/removing a video
+    * Improve notification settings organization
+ * Video/live views:
+   * Add ability for admins to change local buffer update interval
+   * Add ability for admins to change view expiration for a specific IP
+   * Introduce `viewers` attribute for live videos and reduce delay to see `viewers` update in the interface
+   * Take into accounts `views` created during the live when saving replay
+ * Add markdown support for playlist description [#4489](https://github.com/Chocobozzz/PeerTube/pull/4489)
+ * Improve video playback when having invalid redundancy URLs
+ * Load video resolutions before video starts in player settings menu
+ * Optimize federation:
+   * Correctly set HTTP request timeout
+   * Process slow/bad targets in a dedicated queue
+   * Optimize ActivityPub outbox fetch
+ * Automatically update `publishedAt` attribute when re-streaming in a permanent live
+ * Add ability for users to view their followers
+ * Add ability for users to filter their videos per channel
+ * Add ability for admins to show author display name instead of username in video miniatures [#4422](https://github.com/Chocobozzz/PeerTube/pull/4422)
+ * Add ability for admins to filter logs by tags
+ * Add ability for admins to configure per user channels limit [#4491](https://github.com/Chocobozzz/PeerTube/pull/4491)
+ * Add available instance themes and plugins in `/about/peertube` page
+ * Remove contributors list from `/about/peertube` since some contributors don't want their name to be displayed on unknown PeerTube instances
+ * Add *Transcoding failed* video state [#4525](https://github.com/Chocobozzz/PeerTube/pull/4525)
+ * Add ability to make a search using a URL containing query parameters
+ * Optimize *channel with video* component in homepage
+
+### Bug fixes
+
+ * Alert user when aborting video upload
+ * Fix youtube-dl update with proxy
+ * Fix *My videos* search on page refresh
+ * Fix homepage request error when having many elements (channels, videos...)
+ * Prevent multiple post-process triggering of upload-resumable [#4175](https://github.com/Chocobozzz/PeerTube/pull/4175)
+ * Fix remote interaction on remote content
+ * Fix HLS transcoding job when running `create-transcoding-job` CLI
+ * Fix import error log on failed import
+ * Fix transcoding with very low input bitrate
+ * Update `updatedAt` video attribute on thumbnail update
+ * Fix local video concurrent update
+ * Fix redundancy error when PeerTube tries to extend/remove redundancy
+ * Fix account switch in account channels page
+ * Hide job progress information for jobs that don't support it
+ * Fix player settings menu keyboard navigation
+ * Fix player placeholder width
+ * Fix playlist miniature size with big description
+ * Correctly escape meta tags
+ * Fix audio upload client bug if not enabled by instance
+ * Add header Vary Accept-Language [#4588](https://github.com/Chocobozzz/PeerTube/pull/4588)
+ * Fix additional extensions admin config description
+ * Fix upload of video with long filename
+ * Fix pending transcoding counter with failed job
+ * Fix client header search on ios
+ * Fix iframe attribute `allow-popups` for oembed
+ * Fix theme update when logged in
+ * Fix homepage title
+
+
 ## v3.4.1
 
 ### Bug fixes
 
 ### Plugins/Themes/Embed API
 
-*Documentation: https://docs.joinpeertube.org/api-plugins*
+*Documentation: https://docs.joinpeertube.org/api/plugins*
 
  * Server helpers
    * **Deprecate** `videoLanguageManager.addLanguage` and `videoLanguageManager.deleteLanguage`: use `videoLanguageManager.addConstant` and `videoLanguageManager.deleteConstant` instead
 
 ### Custom markup API
 
-*Documentation: https://docs.joinpeertube.org/api-custom-client-markup*
+*Documentation: https://docs.joinpeertube.org/api/custom-client-markup*
 
  * Add ability to only display VOD or live videos in `<peertube-videos-list>` element
  * `<peertube-container>` fills all available width. Can be changed using `data-justify-content` attribute
    * Hide or display sensitive content
    * Choose to display all videos or only local videos
  * :tada: **Beta:** Add support for saving video files in object storage [#4290](https://github.com/Chocobozzz/PeerTube/pull/4290)
-   * Check the documentation: https://docs.joinpeertube.org/admin-remote-storage
+   * Check the documentation: https://docs.joinpeertube.org/admin/remote-storage
  * :tada: Add ability for instances to follow any actor (so specific accounts and channels)
  * Updated HLS.js (library to play HLS playlists in PeerTube player) to V1:
    * Remember last bandwidth to prevent resolution change at the beginning of the video
 ### IMPORTANT NOTES
 
  * **Important:** v3.2.0 introduced a `pg_dump` export bug in the auto upgrade script. v3.2.1 fixed this bug. To upgrade from v3.2.**0**:
-   * You can upgrade manually https://docs.joinpeertube.org/install-any-os?id=manually
+   * You can upgrade manually https://docs.joinpeertube.org/install/any-os#manually
    * Or you can apply the changes introduced in this commit: https://github.com/Chocobozzz/PeerTube/commit/86dc0b9cc9374cba7548bb613ff43d92f90570a8 and then use the auto upgrade script
  * **Important:** Due to a bug in ffmpeg, PeerTube is not compatible with ffmpeg 4.4. See https://github.com/Chocobozzz/PeerTube/issues/3990
 
 
  * Add client helpers:
    * `getBaseRouterRoute()` [#4153](https://github.com/Chocobozzz/PeerTube/pull/4153)
- * Add client plugin hooks (https://docs.joinpeertube.org/api-plugins):
+ * Add client plugin hooks (https://docs.joinpeertube.org/api/plugins):
    * `filter:left-menu.links.create.result` to add/remove left menu links
    * `filter:internal.player.videojs.options.result` to filter options sent to videojs player [#4126](https://github.com/Chocobozzz/PeerTube/pull/4126)
- * Add server plugin hooks (https://docs.joinpeertube.org/api-plugins):
+ * Add server plugin hooks (https://docs.joinpeertube.org/api/plugins):
    * `action:api.video-playlist-element.created`
 
 
 ### Features
 
- * :tada: Add ability to create a custom homepage using HTML, markdown and [custom HTML tags](https://docs.joinpeertube.org/api-custom-client-markup) [#4007](https://github.com/Chocobozzz/PeerTube/pull/4007)
+ * :tada: Add ability to create a custom homepage using HTML, markdown and [custom HTML tags](https://docs.joinpeertube.org/api/custom-client-markup) [#4007](https://github.com/Chocobozzz/PeerTube/pull/4007)
  * :tada: Add ability to search playlists in PeerTube instance and [SepiaSearch](https://sepiasearch.org/)
  * :tada: Shorter public URLs (old URLs are still supported):
    * Handle short UUID (`8r4jooaQpHp8tw1E1qpSeYq` instead of `3caf7bea-5ceb-4959-81a0-b44d184e897c`) for playlists and videos
    * Use `/a/:accountName` instead of `/accounts/:accountName` and `/c/:channelName` instead of `/video-channels/:channelName` [#4009](https://github.com/Chocobozzz/PeerTube/pull/4009)
    * Provide `/@:username` page that automatically redirect to the account or channel page [#4009](https://github.com/Chocobozzz/PeerTube/pull/4009)
  * :tada: Add RTL layout support
- * Add ability to use HTML, markdown and [custom HTML tags](https://docs.joinpeertube.org/api-custom-client-markup) in instance description
+ * Add ability to use HTML, markdown and [custom HTML tags](https://docs.joinpeertube.org/api/custom-client-markup) in instance description
  * Default to dark theme (if available) if requested by the web browser
  * Add ability for admins to configure minimum age required in signup page [#4010](https://github.com/Chocobozzz/PeerTube/pull/4010)
  * Use a dedicated URL for each tab in publish page
 ### IMPORTANT NOTES
 
  * **Important:** v3.2.0 introduced a `pg_dump` export bug in the auto upgrade script. To upgrade from v3.2.0:
-   * You can upgrade manually https://docs.joinpeertube.org/install-any-os?id=manually
+   * You can upgrade manually https://docs.joinpeertube.org/install/any-os#manually
    * Or you can apply the changes introduced in this commit: https://github.com/Chocobozzz/PeerTube/commit/86dc0b9cc9374cba7548bb613ff43d92f90570a8 and then use the auto upgrade script
 
 ### Bug fixes
  * **Important:** Drop NodeJS 10 support
  * PeerTube is not compatible with NodeJS 16 yet
  * By default, HLS transcoding is now enabled and webtorrent is disabled. We suggest you to reflect this change.
- See [the documentation](https://docs.joinpeertube.org/admin-configuration?id=webtorrent-transcoding-or-hls-transcoding) for more information
+ See [the documentation](https://docs.joinpeertube.org/admin/configuration#webtorrent-transcoding-or-hls-transcoding) for more information
  * PeerTube client now displays bigger video thumbnails.
- To fix old thumbnails quality, run `regenerate-thumbnails` script after your PeerTube upgrade: https://docs.joinpeertube.org/maintain-tools?id=regenerate-thumbnailsjs
+ To fix old thumbnails quality, run `regenerate-thumbnails` script after your PeerTube upgrade: https://docs.joinpeertube.org/maintain/tools#regenerate-thumbnailsjs
 
 ### Docker
 
 
  * Theme:
    * `--submenuColor` becomes `--submenuBackgroundColor`
- * Support HTML placeholders for plugins. See [the documentation](https://docs.joinpeertube.org/contribute-plugins?id=html-placeholder-elements) for more information
+ * Support HTML placeholders for plugins. See [the documentation](https://docs.joinpeertube.org/contribute/plugins#html-placeholder-elements) for more information
    * `player-next` next to the PeerTube player
- * Support storing files for plugins in a dedicated directory. See [the documentation](https://docs.joinpeertube.org/contribute-plugins?id=storage) for more information
+ * Support storing files for plugins in a dedicated directory. See [the documentation](https://docs.joinpeertube.org/contribute/plugins#storage) for more information
  * Transcoding:
    * Add `inputOptions` option support for transcoding profile [#3917](https://github.com/Chocobozzz/PeerTube/pull/3917)
    * Add `scaleFilter.name` option support for transcoding profile [#3917](https://github.com/Chocobozzz/PeerTube/pull/3917)
    * `plugin.getBaseRouterRoute()`
    * `plugin.getDataDirectoryPath()`
    * `user.getAuthUser()`
- * Add client plugin hooks (https://docs.joinpeertube.org/api-plugins):
+ * Add client plugin hooks (https://docs.joinpeertube.org/api/plugins):
    * `action:modal.video-download.shown`
    * `action:video-upload.init`
    * `action:video-url-import.init`
    * `action:auth-user.logged-in` & `action:auth-user.logged-out`
    * `action:auth-user.information-loaded`
    * `action:admin-plugin-settings.init`
- * Add server plugin hooks (https://docs.joinpeertube.org/api-plugins):
+ * Add server plugin hooks (https://docs.joinpeertube.org/api/plugins):
    * `filter:api.download.video.allowed.result` & `filter:api.download.torrent.allowed.result` to forbid download
    * `filter:html.embed.video-playlist.allowed.result` & `filter:html.embed.video.allowed.result` to forbid embed
    * `filter:api.search.videos.local.list.params` & `filter:api.search.videos.local.list.result`
 
 ### Plugins/Themes/Embed API
 
- * Add server plugin hooks (https://docs.joinpeertube.org/api-plugins):
+ * Add server plugin hooks (https://docs.joinpeertube.org/api/plugins):
    * `filter:api.user.me.videos.list.params` and `filter:api.user.me.videos.list.result`
  * Add server helpers:
    * `videos.loadByIdOrUUID`
- * Add server transcoding helpers (https://docs.joinpeertube.org/contribute-plugins?id=add-new-transcoding-profiles):
+ * Add server transcoding helpers (https://docs.joinpeertube.org/contribute/plugins#add-new-transcoding-profiles):
    * `transcodingManager.addVODProfile`
    * `transcodingManager.addVODEncoderPriority`
    * `transcodingManager.addLiveProfile`
 
 ### Docker
 
- * Fix [upgrade documentation](https://docs.joinpeertube.org/install-docker?id=upgrade)
+ * Fix [upgrade documentation](https://docs.joinpeertube.org/install/docker#upgrade)
  * Add live RTMP port in docker compose
 
 ### Bug fixes
  * Replace traefik by nginx in our docker-compose template:
    * Better consistency with our default setup (we now use the same stack)
    * Use our default nginx template enabling many optimizations
-   * Update the documentation to take into account this change: https://docs.joinpeertube.org/install-docker
+   * Update the documentation to take into account this change: https://docs.joinpeertube.org/install/docker
 
 ### Plugins/Themes/Embed API
 
  * Add ability for auth plugins to redirect user on logout [#32](https://framagit.org/framasoft/peertube/PeerTube/-/merge_requests/32) & [#33](https://framagit.org/framasoft/peertube/PeerTube/-/merge_requests/33)
  * Add `input-password` setting to plugins [#3375](https://github.com/Chocobozzz/PeerTube/issues/3375)
- * Add server plugin hooks (https://docs.joinpeertube.org/api-plugins):
+ * Add server plugin hooks (https://docs.joinpeertube.org/api/plugins):
    * `filter:api.accounts.videos.list.params`
    * `filter:api.accounts.videos.list.result`
    * `filter:api.video-channels.videos.list.params`
 
 ### Plugins/Themes/Embed API
 
- * Add embed API (https://docs.joinpeertube.org/api-embed-player):
+ * Add embed API (https://docs.joinpeertube.org/api/embed-player):
    * `playNextVideo` method
    * `playPreviousVideo` method
    * `getCurrentPosition` method
  * Embed URL parameters
    * Add ability to disable PeerTube link in embed using an URL param (`peertubeLink=0`)
  * Add plugins support in embed
- * Add client plugin hooks (https://docs.joinpeertube.org/api-plugins):
+ * Add client plugin hooks (https://docs.joinpeertube.org/api/plugins):
    * `action:embed.player.loaded` (for embed)
- * Add custom fields in video update/upload form using `registerVideoField` (https://docs.joinpeertube.org/contribute-plugins?id=add-custom-fields-to-video-form)
+ * Add custom fields in video update/upload form using `registerVideoField` (https://docs.joinpeertube.org/contribute/plugins#add-custom-fields-to-video-form)
 
 ### Features
 
@@ -910,7 +1769,7 @@ A new endpoint to report videos will be created in PeerTube 2.4 and will also al
 
 ### CLI tools
 
- * Add redundancy CLI: https://docs.joinpeertube.org/maintain-tools?id=peertube-redundancyjs
+ * Add redundancy CLI: https://docs.joinpeertube.org/maintain/tools#peertube-redundancyjs
  * Add ability to pass remaining options to youtube-dl binary in peertube-import script ([@drzraf](https://github.com/drzraf))
 
 ### Docker
@@ -920,19 +1779,19 @@ A new endpoint to report videos will be created in PeerTube 2.4 and will also al
 
 ### Maintenance
 
- * Add nginx configuration to redirect videos to an S3 bucket ([@rigelk](https://github.com/rigelk)) and update of the [corresponding documentation](https://docs.joinpeertube.org/admin-remote-storage).
+ * Add nginx configuration to redirect videos to an S3 bucket ([@rigelk](https://github.com/rigelk)) and update of the [corresponding documentation](https://docs.joinpeertube.org/admin/remote-storage).
 
 ### Plugins/Themes/Embed API
 
- * Add embed API (https://docs.joinpeertube.org/api-embed-player):
+ * Add embed API (https://docs.joinpeertube.org/api/embed-player):
    * `playbackState` can be `ended`
    * `playbackStatusUpdate` has a `duration` field
    * `setCaption` and `getCaptions` methods
- * Add client plugin hooks (https://docs.joinpeertube.org/api-plugins):
+ * Add client plugin hooks (https://docs.joinpeertube.org/api/plugins):
    * `action:login.init`
    * `action:video-watch.video-threads.loaded`
    * `action:video-watch.video-thread-replies.loaded` ([@ipbc-dev](https://github.com/ipbc-dev))
- * Add server plugin hooks (https://docs.joinpeertube.org/api-plugins):
+ * Add server plugin hooks (https://docs.joinpeertube.org/api/plugins):
    * `filter:api.video.pre-import-url.accept.result`
    * `filter:api.video.pre-import-torrent.accept.result`
    * `filter:api.video.post-import-url.accept.result`
@@ -1124,13 +1983,13 @@ A new endpoint to report videos will be created in PeerTube 2.4 and will also al
 
 We added some sections in the documentation website:
 
- * S3 remote storage: https://docs.joinpeertube.org/admin-remote-storage
- * Instances redundancy: https://docs.joinpeertube.org/admin-following-instances
- * Moderate your instance: https://docs.joinpeertube.org/admin-moderation
- * Customize your instance (install plugins & themes): https://docs.joinpeertube.org/admin-customize-instance
- * PeerTube logs (standard log/audit log): https://docs.joinpeertube.org/admin-logs
- * Mute accounts/instances: https://docs.joinpeertube.org/use-mute
- * Controlled player embed API: https://docs.joinpeertube.org/api-embed-player
+ * S3 remote storage: https://docs.joinpeertube.org/admin/remote-storage
+ * Instances redundancy: https://docs.joinpeertube.org/admin/following-instances
+ * Moderate your instance: https://docs.joinpeertube.org/admin/moderation
+ * Customize your instance (install plugins & themes): https://docs.joinpeertube.org/admin/customize-instance
+ * PeerTube logs (standard log/audit log): https://docs.joinpeertube.org/admin/logs
+ * Mute accounts/instances: https://docs.joinpeertube.org/use/mute
+ * Controlled player embed API: https://docs.joinpeertube.org/api/embed-player
 
 ### Docker
 
@@ -1165,7 +2024,7 @@ We added some sections in the documentation website:
 
  * PeerTube moved translations from Zanata to Weblate. Here is the new translations website URL: https://weblate.framasoft.org/projects/peertube/
  * We now provide a JavaScript library to control a PeerTube embed: https://www.npmjs.com/package/@peertube/embed-api
- * Add ability to generate HLS videos using `create-transcoding-job` script (see [the documentation](https://docs.joinpeertube.org/maintain-tools?id=create-transcoding-jobjs))
+ * Add ability to generate HLS videos using `create-transcoding-job` script (see [the documentation](https://docs.joinpeertube.org/maintain/tools#create-transcoding-jobjs))
  * Update nginx template: (you need to [update manually](https://github.com/Chocobozzz/PeerTube/blob/develop/support/doc/production.md#nginx))
    * Add streaming playlists endpoint
    * Add `client_body_temp_path` hint
@@ -1434,7 +2293,7 @@ We added some sections in the documentation website:
 ### Features
 
  * :tada: Support Finnish, Greek and Scottish Gaelic languages
- * :tada: Add basic plugins and themes support (**beta**): https://docs.joinpeertube.org/contribute-plugins
+ * :tada: Add basic plugins and themes support (**beta**): https://docs.joinpeertube.org/contribute/plugins
    * Install plugins or themes from the administration panel
    * Choose a default theme for your instance
    * Users can choose the theme they want among the list of themes their administrator installed
@@ -2140,8 +2999,8 @@ This version is a pre release because it contains many important changes, and re
 **Important:** Before upgrading run the following commands (no need to stop PeerTube) on your PeerTube database (in this example it's *peertube_prod*):
 
 ```
-sudo -u postgres psql peertube_prod -c 'CREATE EXTENSION IF NOT EXISTS unaccent;'
-sudo -u postgres psql peertube_prod -c 'CREATE EXTENSION IF NOT EXISTS pg_trgm;'
+sudo -u postgres psql peertube_prod -c 'CREATE EXTENSION IF NOT EXISTS unaccent;'
+sudo -u postgres psql peertube_prod -c 'CREATE EXTENSION IF NOT EXISTS pg_trgm;'
 ```
 
 You will need [PostgreSQL Contrib](https://www.postgresql.org/docs/9.6/static/contrib.html).