Skip to content

Tkremre/ytcleaner

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

8 Commits
 
 
 
 
 
 
 
 

Repository files navigation

YouTube Cleaner

Bring back a cleaner old-school YouTube desktop layout.

No Shorts.
No noisy subscription sections.
More control over the desktop grid.

YouTube Tampermonkey License: MIT

Install from GitHub Install from Greasy Fork


Introduction

YouTube Cleaner is a lightweight userscript made for people who prefer the older YouTube desktop browsing experience.

It focuses on the interface around the player, not the player itself.

The goal is simple:

  • remove Shorts from the interface
  • remove noisy sections from Subscriptions
  • restore a denser desktop grid when you want it
  • keep YouTube clean, simple, and easier to browse

If you miss the 2015-2016 style YouTube desktop experience, this script tries to bring a bit of that feeling back.


Features

  • Hide YouTube Shorts from the homepage, subscriptions, sidebar, and other common sections
  • Hide the Shorts button from the left sidebar
  • Redirect /shorts/ pages back to the YouTube homepage
  • Remove "Most relevant", recommendations, and similar noisy blocks from the Subscriptions page
  • Switch between automatic YouTube columns and a manual grid
  • Use a slider from 1 to 8 video thumbnails per row
  • Show dislike counts on watch pages with Return YouTube Dislike
  • Add a cleaner-style settings button in the YouTube top bar
  • Split settings into clear menu sections
  • Save your settings locally in your browser

Table of Contents

  1. Installation
  2. Usage
  3. Recommended Settings
  4. Privacy Notes
  5. Common Issues
  6. Update URL
  7. Changelog
  8. Contribution
  9. Disclaimer
  10. License

Installation

1. Install Tampermonkey

If you do not already have Tampermonkey installed, install it for your browser:

2. Install the script

Click here and press Install:

Install YouTube Cleaner

3. Enable the script

Open the Tampermonkey Dashboard and make sure YouTube Cleaner is enabled.

4. Open YouTube

Go to:

https://www.youtube.com

Refresh the page.

You should see a small cleaner icon in the YouTube top bar, near the Create and Notifications buttons.


Usage

Click the YouTube Cleaner button in the YouTube top bar to open the settings menu.

Available settings:

  • General
    • Enable or disable YouTube Cleaner globally
  • Shorts
    • Enable or disable Shorts hiding
    • Enable or disable Shorts page redirection
  • Subscriptions
    • Enable or disable noisy subscription section hiding
  • Layout
    • Use YouTube automatic columns
    • Choose 1 to 8 thumbnails per row with the slider
  • Extras
    • Enable or disable dislike counts on watch pages

Your settings are saved locally in your browser.

No account, server, or custom backend is used by YouTube Cleaner.


Recommended Settings

For a desktop experience closer to older YouTube layouts:

  • Cleaner: enabled
  • Hide Shorts: enabled
  • Redirect Shorts pages: enabled
  • Hide noisy subscription sections: enabled
  • Automatic grid: disabled
  • Manual columns: 5

For large monitors, 6 to 8 columns can also work well.

If YouTube changes its grid again, try enabling Automatic grid first.


Privacy Notes

Most features run entirely in your browser and only change the local YouTube interface.

The Show dislikes option calls the public Return YouTube Dislike API for the current video ID. Keep it disabled if you do not want the script to make that external request.

When dislikes are enabled, YouTube Cleaner keeps YouTube's native like/dislike buttons and injects the Return YouTube Dislike count into the original dislike button.

The dislike count refreshes regularly and stays in a compact YouTube-style format.


Common Issues

The settings button does not appear

Try refreshing YouTube first.

If it still does not appear:

  • make sure Tampermonkey is installed
  • make sure YouTube Cleaner is enabled in the Tampermonkey Dashboard
  • make sure the script is installed for youtube.com
  • try disabling other YouTube-related userscripts or extensions

Shorts are still visible

YouTube changes its interface often, and some layouts can vary depending on language, region, account, or A/B testing.

Try:

  • refreshing the page
  • opening YouTube in a new tab
  • checking that YouTube Cleaner is enabled
  • checking that Hide Shorts is enabled
  • checking that no other YouTube script conflicts with it

If Shorts are still visible, open an issue with:

  • your browser
  • your YouTube language
  • the page where Shorts still appear
  • a screenshot if possible

The grid layout does not change

Try switching Automatic grid off, then move the slider to another value.

If it still does not work, another extension or userscript may be modifying YouTube's layout.


Dislikes do not appear

Make sure Show dislikes is enabled and that you are on a regular /watch?v=... video page.

If it still does not appear:

  • refresh the page
  • check that Tampermonkey allows returnyoutubedislikeapi.com
  • check whether another YouTube extension changes the like button area

The menu opens but looks broken

YouTube may change its theme variables or layout.

Try:

  • refreshing the page
  • switching YouTube between dark and light mode
  • disabling other YouTube interface extensions

If the issue continues, open an issue with a screenshot.


The menu does not open

This script avoids using innerHTML because YouTube may enforce Trusted Types security rules.

If the menu does not open:

  1. Open the browser console
  2. Click the YouTube Cleaner button
  3. Copy the error message
  4. Open an issue with the error

Update URL

YouTube Cleaner is configured to update from GitHub.

Userscript URL:

https://raw.githubusercontent.com/Tkremre/ytcleaner/main/YouTube-Cleaner.user.js

The userscript header uses:

// @updateURL    https://raw.githubusercontent.com/Tkremre/ytcleaner/main/YouTube-Cleaner.user.js
// @downloadURL  https://raw.githubusercontent.com/Tkremre/ytcleaner/main/YouTube-Cleaner.user.js

Make sure the script file is named exactly:

YouTube-Cleaner.user.js

Changelog

1.0.2

  • Fixed the dislike counter placement by keeping YouTube's native reaction buttons
  • Removed the replacement like/dislike button group
  • Removed the compact/full count option after it proved too fragile on YouTube's current layout
  • Kept the dislike count in a compact YouTube-style format
  • Added regular dislike count refresh without touching the native like counter
  • Kept the userscript version aligned with this release at 1.0.2

1.0.1

  • Added separated menu sections for General, Shorts, Subscriptions, Layout, and Extras
  • Added independent toggles for Shorts hiding, subscription cleanup, and dislikes
  • Added more blocked subscription section titles and normalized accent handling
  • Replaced fixed column buttons with Automatic grid plus a 1 to 8 column slider
  • Added optional Return YouTube Dislike counts on watch pages with replacement reaction buttons
  • Improved replacement reaction button animation and optimistic count updates
  • Added regular reaction counter refresh
  • Replaced the top bar tune icon with a cleaner-style icon
  • Kept the userscript version aligned with this release at 1.0.1

1.0.0

  • Initial public release
  • Hide YouTube Shorts across the interface
  • Hide the Shorts button from the left sidebar
  • Redirect /shorts/ pages back to Subscriptions
  • Remove the "Most relevant" section from the Subscriptions page
  • Add a small settings button in the YouTube top bar
  • Choose between 3, 4, 5, or 6 video columns
  • Save settings locally in the browser
  • Support YouTube dark and light themes

Contribution

Suggestions, bug reports, and improvements are welcome.

You can contribute by opening an issue or creating a pull request.

Useful bug reports include:

  • browser name and version
  • operating system
  • YouTube language
  • screenshot of the issue
  • page URL where the issue happens
  • console error if there is one

Useful ideas include:

  • better selectors for hiding Shorts
  • support for more YouTube languages
  • cleaner UI improvements
  • better grid handling for unusual screen sizes
  • better selectors for YouTube UI cleanup

Disclaimer

YouTube Cleaner is not affiliated with YouTube, Google, or Alphabet.

This script only modifies the YouTube interface locally in your browser.


License

This project is licensed under the MIT License.