Overview of Bleep That Shit: Audio and Video Profanity Filtering Tool

Bleep That Shit is an open-source software tool designed to automatically filter, censor, and replace profanity, swear words, curse words, or custom terms in audio and video files. It utilizes a beep or bleep sound effect to mask unwanted words. This tool is built for self-hosting and leverages Python, AI technologies, Streamlit, and Docker to provide a robust and flexible solution for content moderation.

Key Features

Profanity Filtering: Automatically detects and replaces profanity and other specified terms in audio and video files with a beep sound.
Custom Term Censorship: Users can define their own list of words to censor, making the tool adaptable to various contexts and sensitivity levels.
Audio and Video Support: Works with both audio and video files, providing a comprehensive content moderation solution.
Self-Hosting Capability: Designed to be self-hosted, giving users full control over their data and privacy.
AI-Powered: Utilizes AI technologies, including transcription models like Whisper, to accurately identify words to be censored.
Built with Streamlit: Offers a user-friendly web interface built with Streamlit, making it accessible to users with varying levels of technical expertise.
Docker Integration: Easy to set up and deploy using Docker, enhancing portability and scalability.

Installation

Bleep That Shit can be installed and run using Docker or directly with Python. Here are the general steps for both methods:

Using Docker

Set Up Docker: Ensure Docker is installed on your system.
Deploy: Run the following command in your terminal:
```
docker compose up
```
Access: Navigate to http://localhost:8501/ to use the app.

Using Python

Install Requirements: Install the necessary Python packages by running:
```
pip install -r requirements.txt
```

Run the App: Activate the app server with:

streamlit run /home/bleep_that_sht/app.py --server.port=8501 --server.address=0.0.0.0

Access: Open http://localhost:8501/ in a web browser.

Usage

Once installed, the app provides a straightforward interface with three main tabs:

Local Video Upload and Processing: Allows users to upload and process videos stored on their local machine.
YouTube URL Download and Processing: Enables users to input a YouTube URL and process the downloaded video.
About: Offers additional information and user support.

Examples and Walkthroughs

The repository includes detailed examples and a notebook (beep_that_sht_walkthrough.ipynb) that illustrate how to use the tool and customize its functionality. These resources are valuable for both new users and those looking to extend the tool's capabilities.

Licensing

Bleep That Shit is released under the Apache-2.0 license, supporting both personal and commercial use while requiring appropriate attribution and distribution of license terms with any derivative works.

Conclusion

Bleep That Shit provides a practical solution for content creators, broadcasters, and developers looking to moderate audio and video content. By combining advanced AI with user-friendly interfaces and robust self-hosting capabilities, it offers an effective tool for ensuring content meets desired standards of appropriateness.