0.2.82

server/internal/api/features.go

@@ -27,6 +27,7 @@ const (
 	featureGenreBrowser        = "genre_browser"
 	featureTVCalendar          = "tv_calendar"
 	featureWatchTimeDigest     = "watch_time_digest"
+	featureViewers             = "viewers"
 )
 
 type featureDefinition struct {
@@ -146,6 +147,25 @@ var featureCatalogue = []featureDefinition{
 		DefaultEnabled: true, MinimumProtocol: 1,
 		Recovery: "Server-enforced; takes effect before the next summary is due.",
 	},
+	{
+		// Default **off**, the stance the genre browser takes. This is the switch that
+		// decides where a household's watched state is written, and a feature that
+		// arrives already on is one every server running this build starts using before
+		// anybody has decided to — so it is opted into rather than out of.
+		//
+		// Switching it on or off never deletes a viewer or their history: the rows stay
+		// in Postgres and come back intact. Off, the gateway routes nobody's state
+		// anywhere but Emby, which is the state a household was in before the feature
+		// existed; on, a shadow viewer's watching goes to Memby and is picked up exactly
+		// where they left it.
+		Key: featureViewers, Name: "Viewers", Area: "Accounts",
+		Description: "Let one Emby account hold several people, each with their own " +
+			"Continue Watching, watched history and favourites. Off by default; turning " +
+			"it off again returns every television to watching as the account itself, " +
+			"without losing what anybody has watched.",
+		DefaultEnabled: false, MinimumProtocol: 1, Capability: "viewers_v1",
+		Recovery: "Takes effect on the next request; nothing a viewer has watched is lost.",
+	},
 	{
 		Key: featureInstallPermission, Name: "Ask TVs for install permission", Area: "Setup",
 		Description: "Ask a signed-in TV that cannot install its own updates to grant the " +