+## 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