feat-playback - Add preferTextSubtitles and preferExternalSubtitles user defaults

[mattsigal]

Pull Request

Summary

Adds preferTextSubtitles and preferExternalSubtitles boolean settings to the user settings profile schema and default profile configuration, allowing client preferences for prioritizing text-based and external subtitle streams to persist and synchronize across devices.

Related Issues

Link related issues or tickets separated by commas.

• Closes #
• Fixes #
• Related to # Add settings to prefer text subtitles and external subtitles Moonfin-Core#1656

Type of Change

• Bug fix
• New feature
• Refactor
• Performance improvement
• API / endpoint change
• Settings schema change
• Documentation update
• Build/CI change
• Other (describe):

Area

• Settings sync / profiles
• Admin defaults / config page
• Ratings (MDBList / TMDB)
• Notifications / Push (FCM / relay)
• Seerr integration
• Games / Emulators
• Custom home rows
• Web Client (Go to Moonfin-Core repo)
• Other / shared

Changes Made

List the key changes included in this PR.

• Added PreferTextSubtitles and PreferExternalSubtitles nullable boolean properties to UserSettingsProfile.cs.
• Added default values (false) to PluginConfiguration.cs.
• Exposed settings in the Moonbase web administration UI (configPage.html) under Subtitle Stream preferences with descriptive labels and toggles.

Client Impact

Does this need matching changes in a client repo (Core, Smart-TV, Roku)?

• No client changes needed
• Companion client PR(s) required, linked here:
  • Moonfin-Core PR: Add settings to prefer text subtitles and external subtitles Moonfin-Core#1656
  • Smart-TV PR: bugfix+feat-playback - Port new subtitle settings and fix display logic for Details page Smart-TV#460
  • Roku PR: bugfix+feat(subtitles) - Port new subtitle settings and fix display logic for Details page Roku#290
• New setting keys added. List each key and confirm it matches the client key exactly, including casing:
  • preferTextSubtitles (boolean)
  • preferExternalSubtitles (boolean)

Compatibility

• Change to the settings profile is additive only, no renamed or removed properties
• New properties use the same type the client sends (a client bool maps to bool?, an int to int?)
• Migration added for any renamed or removed settings
• Older clients still work, unknown fields are ignored and no keys were removed

Testing

Describe how this change was tested.

• Built the plugin and deployed to a Jellyfin server
• Verified against a live client (which one:) Core (Windows) and Smart-TV (webOS emulator)
• Manual testing completed
• Not tested (explain why):

Test Steps

1. Built Moonbase .NET release DLL and deployed to local Jellyfin server.
2. Verified configuration page loads and toggles persist when saved.
3. Verified settings synchronize bidirectionally with Moonfin-Core and Smart-TV clients.

Screenshots (if applicable)

Include config page screenshots or request/response samples where relevant.

Before

After

Checklist

• Code builds successfully
• Code follows project style and conventions
• No unnecessary commented-out code
• No new warnings introduced
• Any new setting keys match the client-side keys exactly

[github-actions]

Build Successful

Both plugins compiled against .NET 8, and both test suites passed.

Property	Value
Commit	f48b793
Jellyfin ABI	10.10.0.0
Emby version	2.3.0.0
Workflow	Build #444