PodScape

Live Demo

PodScape is a Django-based web application that provides a platform for users to discover and listen to podcasts. It allows users to explore a vast collection of podcasts, create playlists, and engage with other podcast enthusiasts. This README file provides an overview of the project and instructions for running it using Docker.

Features

User registration and authentication
Browse and search podcasts by genre, title, and host
Upload podcast
Listen to podcasts directly within the application
Add podcast to favourite
User-friendly interface

Docker Installation(Recommended)

You can use Docker to run PodScape:

Ensure Docker is installed and running on your system.

Clone the repository:

git clone https://github.com/dev-DTECH/podscape.git

Navigate to the project directory:
```
cd podscape
```
Build the Docker image:
```
docker build -t podscape:latest .
```
Run the Docker container:
```
docker run -p 8000:8000 podscape:latest
```
The application should now be accessible at http://localhost:8000/.

Installation

Alternativly, to run PodScape locally, follow these steps:

Clone the repository:

git clone https://github.com/dev-DTECH/podscape.git

Navigate to the project directory:
```
cd podscape
```
Create a virtual environment (optional but recommended):
```
python3 -m venv venv
```

Activate the virtual environment:

# On macOS and Linux
source venv/bin/activate

# On Windows
venv\Scripts\activate

Install the project dependencies:
```
pip install -r requirements.txt
```

Set up the database:

 python manage.py makemigrations
 python manage.py migrate
 python manage.py makemigrations player
 python manage.py migrate player
 python manage.py makemigrations favourite
 python manage.py migrate favourite

Create a superuser (admin account):
```
python manage.py createsuperuser
```
Follow the prompts to set a username and password.
Collect static files:
```
python manage.py collectstatic
```
Start the development server:
```
python manage.py runserver
```
The application should now be running locally at http://localhost:8000/.

Configuration

The default configuration for PodScape should work for local development purposes. However, if needed, you can modify the following settings in the podscape/settings.py file:

DATABASES: Configure your database connection settings.
SECRET_KEY: Change the secret key used for cryptographic signing.
DEBUG: Set to False in production.

Please note that when deploying PodScape to a production environment, it's essential to follow the appropriate security measures, such as using secure secret keys, enabling HTTPS, and configuring the database for production use.

Contributing

Contributions to PodScape are welcome! If you find a bug or have suggestions for new features, please submit an issue or create a pull request on the GitHub repository. Make sure to follow the project's coding style and provide clear commit messages for your changes.

License

PodScape is open source and released under the MIT License. Feel free to modify and distribute the application as per the license terms.

Acknowledgments

PodScape is built using the Django web framework, along with several other open-source libraries and tools. We would like to acknowledge and express our gratitude to the following projects:

Django: The high-level Python web framework that makes building web applications a breeze.
Django REST Framework: A powerful toolkit for building Web APIs in Django.
Docker: A containerization platform that simplifies the deployment and scaling of applications.

Without the contributions of these projects and their vibrant communities, PodScape would not have been possible.

Contact

If you have any questions, suggestions, or feedback, feel free to reach out to the PodScape team at contact@devdt.in.

Thank you for using PodScape! We hope you enjoy exploring the world of podcasts with our application.