YouTube Enhancer Extension 🚀

The YouTube Enhancer Extension is a powerful browser extension designed to enhance your YouTube experience.

Table of Contents

• Introduction
• Features
• Installing from pre-built package
• Building the Extension
• Configuration
• Usage
• Contributing
• Contributors
• Internationalization (i18n)
• License

🌟 Introduction

YouTube Enhancer is a browser extension that aims to improve your YouTube experience by providing a set of customizable features and enhancements. Whether you want to fine-tune your video settings, improve navigation, or simplify common tasks, this extension has you covered.

🎛️ Features • 64 features

Miscellaneous • 40 features

• Automatic Theater Mode: Automatically enables theater mode when you load a video
• Automatically Disable Ambient Mode: Automatically disables ambient mode when you load a video
• Automatically Disable Autoplay: Automatically disables autoplay when you load a video
• Automatically Disable Closed Captions: Automatically disables closed captions when you load a video
• Automatically Enable Closed Captions: Automatically enables closed captions when you load a video
• Automatically Maximize Player: Automatically maximizes the player when you load a video
• Automatically Show More Videos On End Screen: Automatically shows more videos on end screen when you load a video
• Block Number Key Seeking: Prevents pressing 0-9 from jumping to a percentage of the video
• Copy Video URL With Timestamp Button: Copies video URL with timestamp (?t=123)
• Default To Original Audio Track: Always default to the original audio track
• Horizontal Video Flip Button: Adds a button to flip the video horizontally
• Vertical Video Flip Button: Adds a button to flip the video vertically
• Hide AI: Hides AI-powered features, such as video summaries, Ask AI
• Hide End Screen Cards: Hides the cards at the end of the video
• Hide End Screen Cards Button: Adds a button to show/hide the cards at the end of the video
• Hide Live Stream Chat: Hides the live stream chat
• Hide Members-only Videos: Hides videos that are only visible to members
• Hide Official Artist Videos: Hide Official Artist Videos from Home Page
• Hide Paid Promotion Banner: Hides the banner that appears when you watch a video that has a paid promotion
• Hide Playables: Hides all playables
• Hide Playlists From Homepage: Get rid of playlists from homepage
• Hide Posts: Hides posts from the home page
• Hide Scrollbar: Hides the pages scrollbar
• Hide Recommended Videos: Hides the sidebar that recommends videos
• Hide Translate Comment Button: Hides 'Translate to Language' button under comments
• Loop Button: Adds a button to the feature menu to loop the video you're watching
• Maximize Player Button: Adds a button to the feature menu to maximize the player
• Mono To Stereo Button: Adds a button to convert mono audio to stereo. Stereo tracks remain unchanged.
• Open Transcript Button: Adds a button to the feature menu to open the transcript of the video you're watching
• Open You Tube Settings On Hover: Opens the YouTube settings menu when you hover over the settings button
• Pause Background Players: Pauses video players in background tabs when you start a new player in foreground tab
• Remaining Time: Shows the remaining time of the video you're watching
• Remember Last Volume: Remembers the volume of the last video you were watching and sets it when you open a new video
• Remove You Tube /redirect URLs: Replaces YouTube redirect by actual URLs, skipping redirect warning dialogue
• Restore Fullscreen Scrolling: Restores scrolling in fullscreen mode
• Enable Save To Watch Later Button: Adds a button to Home and Subscriptions videos to save the video to the 'Watch Later' playlist
• Shorten You Tube Video Share Link: Shortens YouTube video share link (youtu.be) by stripping si/feature parameters from it
• Shorts Auto Scroll: Automatically scrolls to the next short
• Skip "Video Is Paused. Continue Watching?": Skips the idle dialog that pauses video playback
• Timestamp Preview: Preview the video by hovering over a timestamp. Click the preview to start playback from that moment.

Deep Dark CSS

• Deep Dark Theme: Activate the selected theme for the page
• Select Theme: Select a theme to be applied to the page
  • Options: 9anime, Adapta-Breath-Nokto, Adapta-Nokto, Arc-Dark, Black-and-White, Breeze-Dark, Custom, Deep-Dark, Discord, Dracula, Firefox-57, Firefox-Alpenglow-Dark, Firefox-Dark, Firefox-Dark-91, Gruvbox-Dark, Gruvbox-Light, HavocOS, Inspired-Dark, Jisho, Mint-Y-Dark, NierAutomata-Dark, NierAutomata-Light, Orange, Solarized-Dark, Solarized-Light, Ubuntu-Grey, Ubuntu-Purple, Vertex-Dark, Yellow, Yellow-2, YouTube-Dark
• Accent Color: Color for accent
• Main Background Color: Color for main background
• Secondary Background Color: Color for secondary background
• Hover Background Color: Color for hover background
• Main Text Color: Color for main text
• Secondary Text Color: Color for secondary text
• Shadow Color: Color for shadows

Forward Rewind Buttons

• Forward/rewind Buttons: Adds forward and rewind buttons to the video player
• Forward/rewind Time: The amount of time to forward/rewind the video by

Global Volume

• Always Start Videos With This Volume: Makes all videos begin at your selected volume automatically
• Video Start Volume: The volume applied to every video when it begins playing

Hide Shorts • 5 features

• Hide On Channel Pages: Removes the Shorts shelf and tab on channel pages
• Hide On Home Feed: Removes the Shorts section from the Home feed
• Hide In Search Results: Removes Shorts videos from search results
• Hide In Sidebar: Removes the Shorts button from the sidebar
• Hide On Watch Pages: Removes Shorts videos from recommendations on watch pages

Mini Player • 2 features (2 settings)

• Open Mini Player When Viewing Comments: Automatically opens the Mini Player when you scroll to comments.
• Mini Player Button: Adds a button that opens the Mini Player
• Default Mini Player Position: Sets the starting position before you move the Mini Player.
  • Options: Bottom center, Bottom left, Bottom right, Top center, Top left, Top right
• Default Mini Player Size: Sets the initial size before you resize the Mini Player.
  • Options: 320x180, 400x225, 480x270, 560x315

Player Quality

• Automatic Quality Adjustment: Automatically adjusts the video quality to the selected level.
• Player Quality: The quality to set the video to
  • Options: Auto, 4320p, 2880p, 2160p, 1440p, 1080p, 720p, 480p, 360p, 240p, 144p
• Quality Fallback Strategy: The strategy to use when the selected quality is not available
  • Options: Higher, Lower

Player Speed • 2 features (2 settings)

• Playback Speed Buttons: Adds buttons to increase or decrease the playback speed of the video you're watching
• Forced Playback Speed: Sets the video speed to what you choose below
• Playback Buttons Speed: Amount of speed to be changed per click
• Player Speed: The speed to set the video to

Playlist Length

• Display Playlist Length Information: Shows the total length of the playlist, how much has been watched, and how much remains.
• Method To Get Playlist Length: The way to get playlist length information (API method will fallback to HTML if an error occurs)
  • Options: API, HTML
• Method To Get Watched Time: The way to get the amount of time watched (Video Length type only used on watch page)
  • Options: Video Length, Video Watch Time

Playlist Management Buttons • 2 features

• Remove Video Button: Adds a button to remove videos from the playlist
• Mark As Unwatched Button: Adds a button to mark videos as unwatched

Screenshot Button

• Screenshot Button: Adds a button to the player to take a screenshot of the video
• Screenshot Format: The format to save the screenshot in
  • Options: PNG, JPEG, WEBP
• Screenshot Save Type: The screenshot save type
  • Options: File, Clipboard, Both (File and Clipboard)

Scroll Wheel Speed Control

• Scroll Wheel Speed Control: Press a modifier key to enable speed adjustment with the scroll wheel.
• Modifier Key: The modifier key to use
  • Options: Alt key, Ctrl key, Shift key
• Speed Change Per Scroll: Adjust the speed change per scroll

Scroll Wheel Volume Control • 3 features (2 settings)

• Scroll Wheel Volume Control: Lets you use the scroll wheel to control the volume of the video you're watching
• When Holding Right Click: Hold right click to enable scroll wheel volume control
• When Holding Modifier Key: Press a modifier key to enable volume adjustment with the scroll wheel.
• Modifier Key: The modifier key to use
  • Options: Alt key, Ctrl key, Shift key
• Volume Change Per Scroll: Adjust the volume change per scroll

Video History

• Track Watched Videos: Keeps track of where you left off on videos you were watching and enables resuming playback
• Resume Type: Select how you want to resume videos
  • Options: Automatic, Prompt

Volume Boost

• Volume Boost: Enable volume boost
• Volume Boost Mode: Choose how volume boost is applied. 'Per video' allows enabling boost for each video individually in the feature menu. 'Global' applies boost to all videos when volume boost is enabled.
  • Options: Global, Per video
• Volume Boost Amount (dB): The amount to boost the volume by. You can also scroll over the volume boost button (Shift/Ctrl for larger steps) to adjust it.

Custom CSS

• Custom CSS: Enables custom CSS to be applied to the page
• CSS Code: Custom CSS code input

Installing from pre-built zip archive

To install the YouTube Enhancer Extension from the latest release, follow these steps:

1. Visit the Latest Release Page.

2. Download the pre-built zip archive for your preferred browser.

3. Extract the contents of the zip archive to a directory of your choice.

4. Depending on your browser, follow these steps:

   • Google Chrome, Microsoft Edge, Brave:

     • Open your browser and go to chrome://extensions/ (or edge://extensions/ for Edge, brave://extensions/ for Brave).
     • Enable 'Developer mode'.
     • Click 'Load unpacked' and select the extracted directory.

   • Mozilla Firefox:

     • Open Firefox and go to about:debugging#/runtime/this-firefox.
     • Click on 'Load Temporary Add-on' and select any file in the extracted directory.

5. Test the extension on YouTube to ensure it functions as expected.

That's it! You've successfully installed the YouTube Enhancer Extension from the latest release.

🛠️ Building the Extension

To build the YouTube Enhancer extension from scratch, follow these steps. We'll start with installing the necessary dependencies:

1. Install Required Software

Before you begin, ensure you have the following software installed on your system:

• Node.js and npm: If you don't have Node.js and npm (Node Package Manager) installed, you can download and install them from the official website: Node.js Downloads.

• Git: If you don't have Git installed, download and install it from Git Downloads.

2. Clone the Repository

Next, open your terminal (command prompt or shell) and navigate to the directory where you want to store the YouTube Enhancer extension project. Run the following command to clone the repository:

git clone https://github.com/YouTube-Enhancer/extension.git

3. Navigate to the Project Directory

Change your working directory to the project folder:

cd youtube-enhancer

4. Install Project Dependencies

Inside the project folder, run the following command to install the required dependencies:

npm install

5. Build the Extension

After the installation is complete, build the extension using the following command:

npm run build

This command will bundle the extension's code and assets into a 'dist' directory.

6. Loading the Extension from the 'dist' Folder

After building the extension, you can load it into your browser for testing. Follow these steps:

Depending on your browser, follow these steps:

• Google Chrome, Microsoft Edge, Brave:

  • Open your browser and go to chrome://extensions/ (or edge://extensions/ for Edge, brave://extensions/ for Brave).
  • Enable 'Developer mode'.
  • Click 'Load unpacked' and select the 'dist/Chrome' directory.

• Mozilla Firefox:

  • Open Firefox and go to about:debugging#/runtime/this-firefox.
  • Click on 'Load Temporary Add-on' and select any file in the 'dist/Firefox" directory.

7. Test the Extension

Your extension should now be loaded. Test it on YouTube to ensure it functions as expected.

That's it! You've successfully built the YouTube Enhancer extension from scratch.

⚙ Configuration

The extension provides a range of configuration options to tailor your YouTube experience to your liking. Simply access the extension's settings page to customize its behavior.

🔧 Usage

Using the YouTube Enhancer Extension is straightforward:

1. Ensure the extension is installed and the icon is visible in your browser's toolbar.

2. Click on the extension icon to access its features and settings.

3. Configure the extension according to your preferences. Adjust settings related to volume control, on-screen displays, video quality, playback speed, volume boost, and more.

4. Save your changes to apply them to your YouTube experience.

5. Enjoy an enhanced YouTube experience with the extension's features working seamlessly in the background.

📝 Contributing

Contributions to the YouTube Enhancer Extension are welcome! If you'd like to contribute to the development of this extension or report issues, please refer to the project's GitHub repository.

🤝 Contributors

mist8kengas 🌍 💻 🐛	Nathan 🎨 💻 🌍	Commonly 🐛	Eduardo Aznar 🌍	Lamyergeier 🤔	Jackal Chan 🌍	livingflore 🌍 💻
Patryk Popardowski 🌍	artkfwks 🎨	Luis Felipe 🌍	Vic 🌍	rado84 🐛	pulsar2105 🌍	Granberg 🌍
Secret-Peter 🌍	Marcos C.R. 🤔	Carlos Ramos Luna 🤔	앙시모사우루스 🌍	Mabra51 🤔	Eduardo Aznar 🌍 💻	pyrix 🤔 🎨
CaiCheng-Li 🐛	Lexiosity 🐛	HelloIamarandomperson 💻	The Major 🤔	Dave Nicolson 💻	Dheatly23 💻	Minks S 🐛
kindofabuzz 🛡️	jtoya85 🤔	Illia Bondar 🤔	Hall4y 🌍

🌐 Internationalization (i18n)

Crowdin Translation Project

Our YouTube Enhancer extension supports multiple languages to provide a more inclusive experience for users around the world. We use Crowdin for managing translations.

Contributing Translations

We welcome contributions to improve translations and make the extension accessible to a wider audience. If you'd like to contribute translations or suggest improvements, follow these steps:

1. Visit our Crowdin project.
2. Select your language and start translating.
3. If your language is not listed, feel free to request its addition.

📜 License

The YouTube Enhancer Extension is open-source and available under the MIT License. Feel free to explore, modify, and share it as needed.

🌟 Star History