# Changelog
-## v5.1.0-rc.1
+## 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
* 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
* 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
* 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
- * Add server plugin hooks (https://docs.joinpeertube.org/api/plugins):
- * `filter:api.user.me.subscription-videos.list.params` & `filter:api.user.me.subscription-videos.list.result` [#5648](https://github.com/Chocobozzz/PeerTube/pull/5648)
+ * 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
* 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
* 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
* 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
* 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
* 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. You must fill it before running PeerTube v5: https://github.com/Chocobozzz/PeerTube/blob/v5.0.0/config/production.yaml.example#L14
+ * 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
* **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
+ * `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
**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).