YTLite Settings Categories: Complete Guide to YouTube iOS Tweak Configuration

YTLite organizes its YouTube customization options into 16 distinct settings categories, with half requiring Advanced Mode activation to access granular controls like Playback Quality, Hold-to-Speed gestures, and Shorts-specific modifications.

The YTLite tweak—available in the dayanch96/YTLite repository—implements its configuration interface through Settings.x, dividing features into logical groups that range from basic UI tweaks to deep playback modifications. Understanding these YTLite settings categories allows users to efficiently navigate between standard options and advanced mode exclusives that modify overlay elements, player behavior, and startup preferences.

Always-Visible Settings Categories

These categories appear in the YTLite settings menu regardless of whether Advanced Mode is enabled. They provide essential toggles for interface customization, support links, and app information.

General

Located at Settings.x lines 120–135, this section contains fundamental YouTube modifications including Remove Ads and Background Playback toggles. These are typically the most frequently accessed options for users seeking immediate ad-blocking and audio playback capabilities.

Navbar

Found in Settings.x at lines 138–164, the Navbar category controls visibility of standard YouTube navigation elements. Users can disable cast buttons, notification icons, search bars, and voice-search controls. When Advanced Mode is active, this section expands to include Sticky Navbar, No Sub-bar, No YouTube Logo, and Premium YouTube Logo options.

Tabbar

This section (Settings.x L276–296) manages bottom tab bar customization. Available toggles include removing labels and indicators, re-adding the Explore tab, hiding the Shorts and Subscriptions tabs, and removing the Upload button entirely.

Support Development and Credits

The Support Development category (Settings.x L493–529) links to PayPal, GitHub Sponsors, Buy-Me-A-Coffee, and cryptocurrency donation methods. Contributors (L531–553) displays translator credits, while Open-source Libraries (L555–569) acknowledges third-party dependencies. The Version section (L571–595) displays the installed tweak version and provides cache clearing and settings reset functionality.

Advanced Mode Settings Categories

When the advancedMode switch is enabled, eight additional categories appear in the settings interface. These provide granular control over player behavior, video quality defaults, and gesture controls.

Overlay

Defined in Settings.x lines 167–197, the Overlay category manages UI layer modifications including hiding autoplay toggles, subtitles buttons, HUD messages, previous/next arrows, dark backgrounds, end-screen cards, and fullscreen actions.

Player

Spanning lines 199–233 in Settings.x, this section configures core video player features such as miniplayer behavior, portrait fullscreen mode, Copy with Timestamp functionality, autoplay disable, auto-captions, classic quality selection, extra speed options, and double-tap-to-seek intervals.

Shorts

Located at Settings.x L235–273, this category provides Shorts-specific controls including Shorts-Only Mode, auto-skip functionality, hide Shorts options, progress bar modifications, pinch-to-fullscreen gestures, resume behavior, and hiding the Shorts logo, search, and camera buttons.

Other

The miscellaneous utilities section (Settings.x L300–336) includes Copy Video Info, Post Manager, save profile photo functionality, comment manager tools, album fixes, native share sheets, menu item removals, continue-watching preferences, search history controls, related watch-next settings, comment sorting options, playlist minibar toggles, and RTL disabling.

Gesture and Speed Controls

Three specialized categories manage playback velocity and startup behavior:

• Hold-to-Speed (Settings.x L340–366): Configures the "hold-to-speed" gesture with presets ranging from disabled to 0.25×–5×
• Default Playback Rate (Settings.x L368–394): Sets the default playback speed between 0.25× and 5×
• Startup (Settings.x L452–488): Allows users to set the default launch tab from options including Home, Explore, Shorts, Subscriptions, or Library

Playback Quality Preferences

Network-specific quality defaults are split into two categories:

• Playback Quality on Wi-Fi (Settings.x L395–423): Defines preferred quality from 360p to best/2160p60 when connected to Wi-Fi
• Playback Quality on Cellular (Settings.x L424–452): Mirrors Wi-Fi options but applies specifically to cellular data connections

Technical Implementation in Settings.x

The YTLite settings interface is constructed in Settings.x where each category represents a distinct section object. The conditional rendering logic checks the advancedMode boolean before injecting advanced category rows into the settings table view controller.

// Representative structure from Settings.x
@implementation YTLiteSettingsController

- (void)loadSettingsSections {
    // Core categories always visible (L120-296)
    [self addSection:@"General" withRange:NSMakeRange(120, 15)];    // L120-L135
    [self addSection:@"Navbar" withRange:NSMakeRange(138, 26)];     // L138-L164
    [self addSection:@"Tabbar" withRange:NSMakeRange(276, 20)];     // L276-L296
    
    // Advanced mode conditional (L167-488)
    if ([[NSUserDefaults standardUserDefaults] boolForKey:@"advancedMode"]) {
        [self addSection:@"Overlay" withRange:NSMakeRange(167, 30)];            // L167-L197
        [self addSection:@"Player" withRange:NSMakeRange(199, 34)];             // L199-L233
        [self addSection:@"Shorts" withRange:NSMakeRange(235, 38)];             // L235-L273
        [self addSection:@"Other" withRange:NSMakeRange(300, 36)];              // L300-L336
        [self addSection:@"Hold-to-Speed" withRange:NSMakeRange(340, 26)];      // L340-L366
        [self addSection:@"Default Playback" withRange:NSMakeRange(368, 26)];    // L368-L394
        [self addQualitySections];                                              // L395-L452
        [self addSection:@"Startup" withRange:NSMakeRange(452, 36)];            // L452-L488
    }
    
    // Support sections (L493-595)
    [self addSupportSection];  // L493-L529
    [self addCreditsSection];  // L531-L569
    [self addVersionSection];  // L571-L595
}

@end

According to the source code, basic categories occupy lines 120–296 and 493–595, while advanced categories populate the middle sections between lines 167–488. Each category block contains switch initialization, preference key definitions, and callback handlers that interface with YouTube's view controllers.

Summary

• YTLite provides 16 settings categories split between always-visible and Advanced Mode options
• General, Navbar, and Tabbar form the core always-visible interface controls (Settings.x L120–296)
• Advanced Mode unlocks Overlay, Player, Shorts, Other, speed controls, quality preferences, and startup settings (Settings.x L167–488)
• Support Development, Contributors, Open-source Libraries, and Version remain accessible regardless of mode selection (Settings.x L493–595)
• Categories are implemented as selectable rows in Settings.x that open picker interfaces or toggle controls based on the advancedMode state

Frequently Asked Questions

What is the difference between basic and advanced mode in YTLite?

Basic mode displays only General, Navbar, Tabbar, Support, Credits, and Version categories, providing essential ad-blocking and UI customization. Advanced mode reveals eight additional categories including granular playback controls, Shorts modifications, and gesture settings that require deeper system hooks, all conditional on the advancedMode boolean check in Settings.x.

Where are the video quality settings located in YTLite?

Video quality defaults are found in two Advanced Mode categories: Playback Quality on Wi-Fi (Settings.x L395–423) and Playback Quality on Cellular (Settings.x L424–452). These allow selection from 360p to 2160p60 resolution defaults based on network connection type, with distinct preferences maintained for each connection method.

How do I access the Shorts-specific controls?

Shorts settings appear only when Advanced Mode is enabled, located in Settings.x at lines 235–273. This category includes Shorts-Only Mode, auto-skip, pinch-to-fullscreen, and options to hide the Shorts logo, camera, and search buttons within the Shorts player interface.

Can I reset YTLite settings to default without reinstalling?

Yes, the Version category at Settings.x lines 571–595 contains functionality to reset all settings to default values and clear the tweak's cache. This provides a clean slate for configuration without requiring package reinstallation or affecting your YouTube account data.

{
  "mcpServers": {
    "instagit": {
      "command": "npx",
      "args": ["-y", "instagit@latest"]
    }
  }
}