Skip to content

Version 3.1.0#148

Open
Sv443 wants to merge 580 commits intomainfrom
develop
Open

Version 3.1.0#148
Sv443 wants to merge 580 commits intomainfrom
develop

Conversation

@Sv443
Copy link
Copy Markdown
Owner

@Sv443 Sv443 commented Jun 2, 2025 •
edited
Loading

Check below this list to install the latest stable-ish preview version.

Click here to see everything that is postponed to a later update

Click to expand plugin and internal changes (I did my best to order these by relevance for each section)
  • Plugin Changes:
    (also refer to version 3.1.0's API docs)
    • Migration guide:
      • ⚠️ The plugin sublicense agreement was updated to version 2 to clarify points which were worded poorly. Read the latest version here.
      • ⚠️ POT. BREAKING: Since BYTM now requires plugin intents to be set, make sure to add all intents required by the authenticated functions your plugin calls to the PluginDef object's intents property (which can now also be an array instead of just a bitwise-or'ed number). Read below for a list of functions and their required intents.
      • If you use the BytmDialog, ExImDialog or MarkdownDialog classes directly, switch to the new authenticated functions getBytmDialog(), getExImDialog() and getMarkdownDialog(). Direct access will continue to work until version 4.0.0, but to future-proof your plugin, switch to the new functions as soon as possible, and make sure to add the CreateModalDialogs (32) intent to your plugin definition's intents property.
      • If you were using bytm:ready to reliably wait until all features are initialized, switch to bytm:allReady instead.
        The bytm:ready event is still emitted, but it is now only guaranteed to be emitted when the DOM is loaded and all features have started to initialize.
      • All NanoEmitter subclasses and the interface-exposed NanoEmitter class reference now use CoreUtils' new NanoEmitter class, which grants you access to the powerful onMulti() method to listen to multiple events at once, with configurable behavior.
      • The intents prop can now be an array of PluginIntent enum members.
    • API Changes:
      • ⚠️ POT. BREAKING: Plugins will no longer be able to call authenticated functions without the required intents.
        Intents are now required to be set in the plugin definition object, though for now they will still all be granted and don't need to be explicitly allowed by the user once after installing yet.
        The new intent FullAccess (512) grants all other intents, though you should only use it if your plugin truly requires all intents.
        These are the intents that are now required for the respective functions:
        • getFeatures() - ReadFeatureConfig (1) and optionally SeeHiddenConfigValues (4)
        • saveFeatures() - WriteFeatureConfig (2)
        • setLocale() - WriteTranslations (16)
        • getBytmDialog() - CreateModalDialogs (32)
        • getExImDialog() - CreateModalDialogs (32)
        • getMarkdownDialog() - CreateModalDialogs (32)
        • getAutoLikeData() - ReadAutoLikeData (64)
        • saveAutoLikeData() - WriteAutoLikeData (128)
        • getInternals() - InternalAccess (256)
      • The dialog classes BytmDialog, ExImDialog and MarkdownDialog should now be gotten using the new authenticated getBytmDialog(), getExImDialog() and getMarkdownDialog() functions, respectively.
        Using the direct access will work until version 4.0.0, but it is recommended you switch to the new functions as soon as possible.
      • The PluginDef object's intents property can now be either an array of PluginIntent values or a single number that is the bitwise OR of the intents.
      • Added a new broadcast system based on the BroadcastChannel API (name: bytm-broadcast), used for inter-tab communication. Events are relayed via the site event bytm:siteEvent:broadcast - see src/utils/broadcast.ts for a list of events.
      • Auth tokens are now in the format of a UUIDv4 instead of a 16-character, 36-radix string.
      • registerPlugin() now also returns a permissions object with the int and array properties, which contain all of the bitwise OR of the plugin's intents and an array of the intents that were actually granted to the plugin. The int property can be used with CoreUtils' bitSetHas() function to check if specific intents were granted.
      • A URL to the plugin's changelog file can now be specified in the PluginDef object's homepage.changelog property.
    • API Additions:
      • Added new intents InternalAccess (256) (currently only used by getInternals()) and FullAccess (512) (grants all intents).
      • Added new functions to the interface that allow for better interaction with the siteEvents system:
        • resourceAsString() - Returns a BYTM resource as a string, some of which are cached cross-session in GM storage for better performance.
        • onSiteEvent() - Adds a site event listener.
        • onceSiteEvent() - Adds a site event listener that is only called once and also returns a Promise for use with the async/await pattern.
        • onMultiSiteEvents() - Adds a listener that triggers after one of, or all of the given site events are dispatched, either continuously or just once, with configurable behavior.
        • 🔒 getBytmDialog() (requires intent CreateModalDialogs (32)) - Returns a reference to the BytmDialog class, which can be used to create new generic dialog instances.
        • 🔒 getExImDialog() (requires intent CreateModalDialogs (32)) - Returns a reference to the ExImDialog class, to export and import serializable data.
        • 🔒 getMarkdownDialog() (requires intent CreateModalDialogs (32)) - Returns a reference to the MarkdownDialog class, to render a markdown string in a modal dialog.
        • 🔒 getInternals() (requires intent InternalAccess (256)) - returns some internal function and object references that can be used by core libraries and deeper reaching plugins.
      • Added new events:
        • bytm:preInitPlugin (no arguments) - emitted at the earliest possible point in time, even before the DOM is loaded, to allow plugins to do any immediate but superficial initialization.
        • bytm:allReady (no arguments) - emitted when all features have been initialized and the interface is fully ready to use.
          This triggers much later than bytm:ready, which is emitted when the DOM is loaded and all features are starting to initialize.
          For the fastest response times, use bytm:featureInitialized for every feature your code depends on.
        • bytm:featureInitialized:id (no arguments) - emitted when a feature with the specified key has been initialized.
          In TypeScript, use "bytm:featureInitialized:myFeatureKey" as "bytm:featureInitialized:id" to make the error go away.
        • bytm:artworkCacheEntryAdded - emitted when an album artwork was added to the cache. Gets passed an object with the properties artist, album and entry (object with the props entry.url: string, entry.videoId: string and entry.created: number).
        • bytm:siteEvent:cfgMenuMounted (no arguments) - emitted when the config menu is invisibly mounted to the DOM (not opened yet, but modifiable).
        • bytm:siteEvent:configHeaderSelected: (name: LooseUnion<FeatureCategory>) - emitted when a config header is selected in the config menu, with the name of the selected header. This is usually the feature category name, but can also be an info category name (currently just "about" and "changelog").
        • bytm:siteEvent:voteLabelsAdded (no arguments) - emitted after the Return YouTube Dislike vote labels were added to the DOM.
        • bytm:siteEvent:updateVolumeSliderLabel (no arguments) - emitted to make the volume slider label update its text content.
      • Added SelectorObserver instance searchPage, as the root observer for the YTM search page.
  • Internal Changes:
    • Added @antifeature tracking directive, to indicate that services temporarily log IP addresses and the currently playing song.
    • Added @sv443-network/coreutils as a new core library, accessible on the BYTM API via BYTM.CoreUtils.
    • Updated @sv443-network/userutils to v10.x.x to, among other things, fix two bugs related to the template literal placeholder format. This now allows specifying a single placeholder multiple times per translation string.
    • Switched from UserUtils v9 DataStores to CoreUtils v3 DataStores with tons of improvements, refactors and new features.
    • Made siteEvents system use CoreUtils' improved NanoEmitter, so it can now also be used to listen to multiple events using .onMulti().
    • Moved siteEvents initialization to an earlier point, so that it is no longer initialized alongside features. It is now available to plugins at an earlier point in time, before any feature has started initializing, but still after plugin initialization is already done.
    • Made plugin-specific events (returned by registerPlugin()) use CoreUtils' new NanoEmitter as well.
    • Improved script performance by refactoring the feature initialization process. As an effect of this, bytm:ready will now emit earlier and the new event bytm:allReady will emit much later, once all features have been initialized or the configured timeout has been reached.
    • Added remote data fetching feature for post-3.1.0 use (see Dynamic data fetching system (for selectors, etc.) #168)
    • Updated a boatload of translation values and translation keys. Open this page to find all changes.
    • Some resources are now cached in GM storage, when using the internal function resourceAsString() for even better feature init performance.
    • BYTM now targets ES2020, meaning browser versions from before 2020 will no longer be supported.
    • Added new GM menu commands:
      • These commands are now available by default:
        • Reset the config to its default values
        • Export all config data [WIP]
        • Export all data, including caches [WIP]
        • Import data from a previous export [WIP]
        • Download a console log file to attach to a GitHub issue
      • In advanced mode, you can also use these additional commands:
        • Decompress all GM storage values and list them in the JS console
        • List all raw GM storage values in the JS console
        • Delete all GM storage values (full wipe of all the data BYTM has accumulated)
        • Reset the version session counter
        • List active SelectorObserver listeners in the JS console
        • Compress a value
        • Decompress a value
        • Log the script's initialization timings to the JS console
        • Toggle developer treatments (experiments that are not quite ready for production)
    • Removed GM.getResourceUrl() entirely in favor of fetching resources from a CDN.
    • Arguments to the translation functions can now also be an object that map a placeholder key to a string value, e.g. { name: "John" } for a translation using the new placeholder syntax, e.g. "Hello, ${name}!".
    • The functions sanitizeArtists() and sanitizeSong() will now replace some common Unicode punctuation symbols with their ASCII counterparts (e.g. ‘ -> ').
    • Moved the general feature category to the top of the config menu.
    • Wrapped feature config elements in a new container element with the ID bytm-ftconf-category-${categoryName} to allow for the sidenav to disable all but one at a time.
    • Added ability to render custom info categories in the config menu. Their navigation headers will be aligned to the bottom, and they render arbitrary elements. They use the same general formatting as the new feature category containers, just with their own categoryName (currently just "about" and "changelog").
    • Added intent checking function pluginHasPerms() to interface.ts, which will now check for FullAccess or the given intents before allowing authenticated functions to be called.
    • Added CSS var --bytm-menu-bg-highlight-2 (hex, opacity 1) as a secondary level of highlight to --bytm-menu-bg-highlight.
    • Renamed CSS var --bytm-dialog-height-max to --bytm-dialog-target-height, but only for the config menu. All BytmDialogs will still use --bytm-dialog-height-max.
    • Improved number argument resolution of the functions in src/utils/logging.ts (if the last argument is a number that exceeds the range of the enum LogLevel, it will not be interpreted as a log level anymore, but as a number to be logged).
    • Added dev menu option to print an initialization timing report to the console for debugging performance issues.
    • Added changesets to improve versioning and changelog maintenance.

Preview Version:

Important

The preview version contains unfinished features, could potentially be unstable, and is likely to mess up your configuration data in the early stages.
This is why I highly recommend you fully remove the script and reinstall it manually once the update is released.
Before installing the preview version you should use the config and auto-liked channels menu's export and import functions to back up all your data.


Note

  • The version number will usually not be updated until the update is about to be released. To ensure that the preview version is installed, check whether there's a blue Developer Mode icon in the bottom left of the config menu.
  • The music note emoji (🎵) tells you that the associated item only applies to YTM and not YT.
  • The colored circle emojis (🟡 🟠 🔴) indicate higher levels of effort and potential complications.
  • The warning emoji (⚠️) means there was a breaking change.

@Sv443 Sv443 self-assigned this Jun 2, 2025
@Sv443 Sv443 added bug Something isn't working enhancement New feature or request labels Jun 2, 2025
@Sv443 Sv443 marked this pull request as draft June 7, 2025 23:11
@Sv443 Sv443 marked this pull request as ready for review June 23, 2025 21:40
@Sv443 Sv443 force-pushed the develop branch 3 times, most recently from 1b85370 to 884623f Compare June 24, 2025 15:48
@Sv443 Sv443 mentioned this pull request Oct 11, 2025
Open
Copilot AI review requested due to automatic review settings November 22, 2025 23:31
Copilot AI reviewed Nov 22, 2025
View reviewed changes
Copy link
Copy Markdown

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This is a major feature release (v3.1.0) that introduces significant improvements and new functionality to BetterYTM. The PR adds a redesigned config menu with sidenav, exponential volume scaling, hotkeys for search bar interaction, automatic dismissal of the "Are you still there?" dialog, track numbers in playlists, and numerous plugin API enhancements including a new intent-based permission system.

Key Changes:

  • New sidenav-based config menu with improved UX and organization
  • Plugin system enhancements with intent-based permissions and authenticated APIs
  • Exponential volume slider scaling with configurable curves (x^3, x^4, x^5)
  • New hotkeys for focusing/clearing search bar and double-press guard for number key seeking
  • Automatic "Are you still there?" dialog dismissal feature
  • Migration from ES2017 to ES2020 target with UserUtils → CoreUtils transition

Reviewed changes

Copilot reviewed 86 out of 130 changed files in this pull request and generated 1 comment.

Show a summary per file
File Description
tsconfig.json Updates TypeScript target to ES2020 and lib to ES2024
src/utils/xhr.ts Refactors to use CoreUtils, improves iTunes API handling, increases vote cache TTL
src/utils/translations.ts Adds CoreUtils integration, dev translation tracking, locale direction support
src/utils/misc.ts Major refactoring with new utilities (overflowVal, version session counter, repeat task, resource caching)
src/utils/logging.ts Adds log file export functionality and improved error handling
src/utils/dom.ts Adds sanitizeHtml helper and transplantElement utility
src/types.ts Extensive type additions for new features and better documentation
src/tools/*.ts Build tool improvements with better arg parsing and antifeature directives
src/siteEvents.ts New events and timing improvements with forceEmitSiteEvent workaround
src/serializers.ts New file replacing serializer.ts with full data export support
src/observers.ts Adds searchPage observer for YTM
src/interface.ts Major plugin system overhaul with intent checking and new authenticated APIs
src/index.ts Improved initialization timing with better performance tracking
src/features/volume.ts Implements exponential volume scaling with HTMLMediaElement override
src/features/songLists.ts Adds track numbers and improves list button placement logic
src/features/lyricsCache.ts Migration to debulkified cache format with path-only storage
src/features/lyrics.ts Unicode sanitization and improved URL handling
src/features/input.ts Double-press guard for number key seeking
src/features/hotkeys.ts New search bar focus/clear hotkeys with improved event handling
src/features/behavior.ts "Are you still there?" auto-dismissal with interaction simulation
src/menu/menu_old.ts Complete sidenav redesign with category organization and extra info sections
CSS files Extensive styling updates for new menu layout and component improvements

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

@Sv443 Sv443 requested a review from Copilot March 27, 2026 23:28
Copilot AI reviewed Mar 27, 2026
View reviewed changes
Copy link
Copy Markdown

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Copilot reviewed 54 out of 527 changed files in this pull request and generated 8 comments.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

@Sv443 Sv443 requested a review from Copilot March 27, 2026 23:47
Copilot AI reviewed Mar 27, 2026
View reviewed changes
Copy link
Copy Markdown

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Copilot reviewed 55 out of 528 changed files in this pull request and generated 12 comments.

Comments suppressed due to low confidence (1)

.github/workflows/lint.yml:1

  • Same as build workflow: actions/checkout@v6, actions/setup-node@v6, and actions/cache@v5 are not known valid major versions (up to 2025-08) and likely cause workflow failures. Use known valid tags (commonly v4) or pin to SHAs.
name: "Lint BetterYTM"

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment