Skip to content

peak-flow/chrome-tools

Repository files navigation

Peakflow Tools

A unified Chrome/Brave extension consolidating tab management, volume control, audible tab control, and YouTube declutter features into a single tool.

Features

Tab Management

Feature Shortcut Description
Move to New Window Alt+X Move highlighted tabs to a new browser window
Merge All Windows Alt+M Pull all tabs from every window into the current one
Sort Tabs by URL Alt+S Alphabetically sort non-pinned tabs by URL
Pause All Tabs Alt+P Pause all playing media across all tabs

Volume Control

Per-tab volume slider with Web Audio boost (0–300%). Appears in the popup when the active tab has media.

  • Drag slider to adjust volume (supports boost above 100%)
  • Reset button snaps back to 100%
  • Uses AudioContext + GainNode for boost beyond native limits

Audible Tabs

Lists all tabs currently playing audio. Click a tab to switch to it. Includes a "Pause All" button. A quick "Pause All Tabs" button also appears in Tab Management when audible tabs exist.

YouTube Declutter

Declutters YouTube by hiding distracting UI elements, disabling infinite scroll, removing Shorts, and more. All features are toggleable from the popup with iOS-style switches organized in collapsible accordion sections.

Global ON/OFF toggle in the section header enables or disables all rules at once.

How it works

The content script sets HTML attributes (e.g. remove_homepage="true") on the <html> element. CSS rules use attribute selectors (html[global_enable="true"][feature="true"]) to hide elements. JS features handle dynamic behaviors like ad skipping and SPA navigation detection.

Feature list (42 CSS + 9 JS)

General

  • Hide all Shorts (js)
  • Hide / blur / shrink video thumbnails (css)
  • Disable play on hover (css)
  • Search engine mode (js)

Basic (Homepage)

  • Hide all homepage suggestions (css)
  • Hide sidebar suggestions (css)
  • Hide end-of-video suggestions (css)

Homepage

  • Reveal box for homepage (js)
  • Hide the header (css)
  • Hide all but first row (css)
  • Hide extra rows — Shorts, Trending (css)
  • Disable infinite scroll — homepage (css)
  • Hide Playables (css)

Left Navigation Bar

  • Hide entire sidebar (css)
  • Only show playlists (css)
  • Disable YouTube logo link (css)
  • Hide buttons — Home, Explore, Shorts, Subscriptions (css)

Left Navigation Sections

  • Hide sections — Subscriptions, You/Library, Explore, More from YT, Settings, Footer (css)

Video Player — UX

  • Skip and close ads (js)
  • Disable autoplay (js)
  • Disable ambient mode (js)
  • Disable annotations (js)
  • Auto-expand description (js)
  • Disable scroll in fullscreen (js)
  • Redirect Shorts to default viewer (js)
  • Enable theater mode (js)

Video Player — UI

  • Reveal box for end-of-video (js)
  • Hide overlay suggestions, info cards, play next button (css)
  • Hide menu buttons — Like, Share, Clip (css)
  • Hide likes count, subscriber count, description (css)
  • Hide "More Videos" in embedded player (css)

Video Player — Sidebar

  • Reveal box for sidebar (js)
  • Remove entire sidebar + center content (css)
  • Disable infinite scroll — sidebar (css)
  • Hide extra sidebar tags, live chat (css)

Comments

  • Hide all comments (css)
  • Hide non-timestamp comments (js)
  • Hide usernames, profile pictures, replies, upvotes (css)

Search Results

  • Hide search suggestions, promoted videos (css)
  • Hide Shorts in search results (css)
  • Hide result descriptions, extra results (css)
  • Disable thumbnail slideshow on hover (css)
  • Disable infinite scroll — search (css)

Channel Page

  • Disable autoplay — channel (js)
  • Hide "For You" section (js)
  • Reverse sort channel videos (js)

Subscriptions Page

  • Hide Shorts, live, upcoming, premiere, VODs (css)

Other

  • Hide notification bell (css)
  • Remove context info boxes (css)
  • Grayscale mode (css)

Popup UI

Light theme with compact density. YouTube Declutter section uses collapsible accordion groups — first 3 expanded by default, others collapsed with a count badge showing active features. All toggles are iOS-style red (#f85149) switches.

Install

  1. Open brave://extensions (or chrome://extensions)
  2. Enable Developer mode
  3. Click Load unpacked and select the peakflow-tools/ directory

Architecture

Manifest V3 extension using ES modules in the service worker. No build tools required. Minimum Chrome 110.

peakflow-tools/
  manifest.json
  service-worker.js              # Routes commands and messages
  features/
    youtube/
      youtube-settings.js        # Feature sections + defaults
      youtube-content.js         # Attribute pipeline, SPA detection
      youtube.css                # 42 attribute-gated CSS rules
  popup/
    popup.html / .js / .css      # Extension popup UI
  docs/adr/                      # Architecture decision records

Origin

Consolidates functionality from 5+ separate extensions:

  • Tab to Window/Popup (v3.3.3)
  • Merge Windows (v1.3.0)
  • Tab Sorter (v0.7)
  • Volume Master (v2.4.0)
  • Video Speed Controller (v0.9.5)
  • Remove YouTube Suggestions (v4.3.68) — reimplemented

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages