Skip to content

Upgrade: v1.0.8 to v1.1.0

v1.0.9 is a non-breaking release. No commands were removed. No env vars were deleted. Most users can upgrade with a single command.

Terminal window
brew upgrade nself
# or
nself update

Verify the upgrade:

Terminal window
nself version
# nself v1.1.0 ...
  • Deprecation warning system: CLI now warns on deprecated items via stderr.
  • Plugin SDK Go v0.1.x, new module path, backward compatible with v0.0.x behavior.
  • API sunset dates: Sunset response headers on all API surfaces.
  • Ecosystem-wide deprecation cycle doctrine, 3-phase cycle for all surface types.
Signal typeOld valueNew valueMigration action
Plugin SDK module pathnselfgithub.com/�P1�Update go.mod (plugin authors only)
Bundle namenMedianselfRe-install: �P1� plugin install nTV
Hasura nselfColumn active@deprecated: EOL 2027-04-17Use device_type + device_name

No CLI commands, flags, or env vars changed.

Plugin SDK migration (plugin authors only)

Section titled “Plugin SDK migration (plugin authors only)”

If you maintain a custom plugin and used the old nself package:

Terminal window
go get github.com/nself-org/nself_plugin_sdk@none
go get github.com/nself-org/plugin-sdk-go@v0.1.0
go mod vendor

Update your import:

// Before
import sdk "github.com/nself-org/nself_plugin_sdk"
// After
import sdk "github.com/nself-org/plugin-sdk-go"

The media bundle was renamed from nMedia to nself to align with the ɳTV companion app.

Terminal window
nself plugin install nTV

All underlying plugins (streaming, epg, tmdb, media-processing, recording, etc.) are unchanged.

Hasura schema change (GraphQL consumers only)

Section titled “Hasura schema change (GraphQL consumers only)”

The nself column is now @deprecated. It continues to return data through the support window (until 2027-04-17), after which it will be removed in v1.2.0.

# Deprecated, still works until v1.2.0
{ nself_sessions { user_agent } }
# Use instead
{ nself_sessions { device_type device_name } }

Run the built-in doctor after upgrading:

Terminal window
nself doctor

All checks should pass. If any plugin reports a compatibility warning, run:

Terminal window
nself plugin compat-check