/Untrapped

A browser add-on that eliminates YouTube recommendations, comments, shorts, and additional content.

Primary LanguageJavaScript

Untrapped - Watch YouTube distraction-free

The Problem

The brightest brains of our generation are literally working on ways to use Twitter, Youtube, Instagram, and other social media platforms to make you addicted to the news. Social statisticians, scientists, researchers, and people in lab coats are literally doing this. Your brain will be wrecked if you fall to it or become addicted. I believe that this conflict is modern. Social media has manipulated all the systems to make you dependent on it. Therefore, a whole enormous factory of people are striving to make you addicted to these things, while you stand alone. Learning how to first resist these things is hence the modern individual fight. Setting your own boundaries with no assistance from anyone! By developing a browser add-on that disables YouTube distractions like the suggested sidebar, end-screen video suggestions, user comments, homepage related videos feed, trending tab, turn off autoplay, and more, I hope to solve this issue.

Solution

The extension aims to enhance YouTube's customization and reduce its level of engagement. It offers various features such as the ability to hide suggested videos and customize the user interface according to personal preferences.

Technology

This browser extension is built using JavaScript, which leverages the Chrome API to provide seamless integration and enhanced functionality within the Google Chrome browser.

The extension utilizes the following key components and technologies:

  1. JavaScript: The primary programming language used to develop the extension, enabling dynamic and interactive functionality.
  2. Chrome API: This API provides access to various features and capabilities of the Chrome browser, allowing the extension to interact with and modify the behavior of YouTube's interface.
  3. HTML and CSS: Used for structuring and styling the extension's user interface and content.

To set up the development environment and start working with the extension, please refer to the installation guide and development documentation provided in the repository.

While this extension is currently designed for Google Chrome, compatibility with other browsers using the WebExtensions API, such as Mozilla Firefox and Microsoft Edge, may be possible with some adjustments and additional testing.

We welcome contributions and suggestions from the open-source community to enhance the functionality and performance of the extension. Please refer to the contribution guidelines and developer documentation for more details on how to contribute.

Thank you for your interest in the technology behind this project. We hope you find it useful, and we appreciate any feedback or collaboration to make it even better.

Clone this repository

To clone this repository, follow the steps below:

  1. Ensure you have a web-browser (Google Chrome and Brave are the only browsers supported for now) installed on your system.

  2. Open your terminal or command prompt.

  3. Navigate to the directory where you want to clone the repository.

  4. Execute the following command:

    git clone https://github.com/KishanKokal/Untrapped.git
    

Installation Guide

  1. Once the repository is cloned, navigate into the project directory:

    cd Untrapped
    
  2. Open Google Chrome:

Make sure you have Google Chrome installed on your computer. If not, download and install it from the official Chrome website (https://www.google.com/chrome).

  1. Access the Chrome Extensions page:

Open a new tab in Google Chrome and type the following URL in the address bar: chrome://extensions/. Alternatively, you can access the Extensions page by clicking the three-dot menu icon in the top-right corner of the Chrome window, selecting "More tools," and then choosing "Extensions."

  1. Enable Developer Mode:

On the Extensions page, locate the toggle switch labeled "Developer mode" in the top-right corner of the page and switch it on.

  1. Load the extension:

Click on the "Load unpacked" button that appears after enabling Developer mode. A file picker dialog will open.

  1. Select the extension folder:

In the file picker dialog, navigate to the folder where you cloned the extension files (the folder should contain the manifest.json file). Select the folder and click the "Select Folder" button.

  1. Confirm the installation:

After selecting the extension folder, Chrome will load the extension, and you will see it listed on the Extensions page.

Contributing

Thank you for considering contributing to this browser extension! Contributions from the open-source community are invaluable and greatly appreciated.

To contribute to the project, please follow these guidelines:

  1. Fork the repository and create a new branch for your contributions.
  2. Make your desired changes, whether it be fixing bugs, adding new features, or improving existing functionality.
  3. Ensure that your code adheres to the project's coding standards and guidelines.
  4. Write clear and concise commit messages describing the purpose of your changes.
  5. Test your changes thoroughly to ensure they function as intended.
  6. Submit a pull request to the main repository, clearly documenting the changes you have made.
  7. Engage in the code review process, responding to feedback and making any necessary adjustments.
  8. Once your changes have been reviewed and approved, they will be merged into the main codebase.

If you have any questions or need assistance during the contribution process, feel free to reach out through the contact information provided in the README.

Your contributions are immensely valuable in improving this browser extension and providing users with a better browsing experience. Thank you for your dedication and support!

Acknowledgments

I would like to take this opportunity to express my sincere gratitude to everyone who has supported and contributed to this personal project, which I have open-sourced. While I have developed the core of this browser extension, there are individuals and resources that have played a significant role in its realization.

First and foremost, I would like to thank the creators of the closed-source project, Unhook - Remove YouTube Recommended Videos, for inspiring us to create this extension. Their innovative approach and dedication to improving the YouTube browsing experience have served as a valuable source of inspiration.

I would like to acknowledge my own dedication and effort in developing this extension. It has been a labor of love, and I am grateful for the opportunity to share it with the community.

Finally, I want to thank all the users, testers, and individuals who have provided feedback and support during the development process. Your valuable input has been instrumental in refining and improving this browser extension.

I am excited about the future of this project and look forward to any contributions or collaborations from the community. Together, we can continue to enhance and expand the capabilities of this browser extension.

Once again, I express my heartfelt appreciation to everyone who has been part of this project. Your support and involvement have been invaluable.

Contact

If you have any questions, feedback, or suggestions regarding this browser extension, please don't hesitate to reach out. I welcome any inquiries and am committed to providing assistance and support to the best of my abilities.

You can contact me via email at kokalkishan1072@gmail.com. I will make sure to respond as promptly as possible.

Additionally, you can find the project's repository on GitHub at Untrapped. Feel free to open issues or submit pull requests for any bug reports, feature requests, or code contributions. I appreciate any contributions and collaboration from the open-source community.

Thank you for your interest in this project, and I look forward to hearing from you!