Favcription is a Django-based application designed to help you focus on specific content from YouTube channels you're interested in. For instance, if you follow several English teachers on YouTube and want to view only their videos about "speaking," Favcription allows you to group these channels and filter their content based on specific keywords. This way, you can save time by only viewing the content that matters to you.
- Group Channels: Create groups of YouTube channels you follow.
- Keyword Filtering: Assign up to three keywords to each group to filter content. Only videos that match these keywords will be displayed.
- Google Account Integration: Easily connect your YouTube account using your Google account.
- YouTube API Integration: Retrieve and manage your YouTube channels directly from your account.
💙 The Story Behind the Name "Favcription"
The name "Favcription" is a combination of the words "favorite" and "subscription." It represents the idea of subscribing to your favorite content.
1- Clone the repository:
git clone https://github.com/your-username/favcription.git
cd favcription
2- Set up environment variables: Create a .env file in the project root directory add the following environment-specific settings:
SECRET_KEY=your-secret-key
DEBUG=True
DB_ENGINE=django.db.backends.postgresql
DB_NAME=yourdatabase
DB_USER=username
DB_PASSWORD=password
DB_HOST=db
DB_PORT=5432
# Database configuration for Docker environment
DATABASE_URL=postgres://username:password@db/yourdatabase
Follow this guide to create your Google Cloud account and obtain the client_secret.json file: How to Get Client ID and Client Secret in Google Cloud Platform. Place the downloaded client_secret.json file in the root directory of your project.
Hint: add this url in your Authorized redirect URIs at cloud
http://localhost:8000/api/oauth2callback/
4- Create and activate a virtual environment:
python -m venv venv
source venv/bin/activate
5- Install the required dependencies:
pip install -r requirements.txt
6- Clone the repository:
git clone https://github.com/your-username/favcription.git
cd favcription
7- Apply database migrations and run the server
python manage.py migrate
python manage.py runserver
4- Build and start the Docker containers:
docker-compose up --build
5- Run the development server: create account in the ngrock and add your url in your Authorized redirect URIs
Hint: add this url in your Authorized redirect URIs at cloud
http://<your-random-ip>.ngrok-free.app/api/oauth2callback/
and than in another terminal run this command
ngrok http 8000
6- start or Stop the Docker containers:
docker-compose up
docker-compose down
Contributions are welcome! Please fork this repository and submit a pull request for any enhancements or bug fixes.
If you have any questions or feedback, feel free to reach out.