Podimo is a proprietary podcasting player that enables you to listen to various exclusive shows behind a paywall. This tool allows you to stream Podimo podcasts with your preferred podcast player, without having to use the Podimo app.
Make sure you have a recent Python 3 version installed, as this is required for the steps below.
- Clone this repository and enter the newly created directory
git clone https://github.com/ThijsRay/podimo
cd podimo
- Get the latest update and install it as a service with
make update
make install
- Run the program with
make start
- Visit http://localhost:12104. You should see the site now! If you want to reach it from other machines, make sure to edit the configuration with
make config
A complete list of all configuration options can be found in the .env.example file
- Pull the Docker image with
docker pull ghcr.io/thijsray/podimo:latest
- Run the Docker image. Make sure you set the correct environment variables if you want to configure any variables. See .env.example for a full list of configuration options.
docker run --rm \
-e PODIMO_BIND_HOST=0.0.0.0:12104 \
-p 12104:12104 \
-v $(pwd)/cache:/src/cache \
ghcr.io/thijsray/podimo:latest
- Visit http://localhost:12104. You should see the site now!
A complete list of all configuration options can be found in the .env.example file
Depending on your usage patterns, it might be necessary to bypass Podimo's anti-bot mechanisms. This can be done through a Zenrows, ScraperAPI or a generic HTTP proxy.
You can create a free trial account for Zenrows
- Go to app.zenrows.com/register and create a free account
- Copy your API key and make sure to add it to the
ZENROWS_API
environment variable
You can create a free trial account for ScraperAPI
- Go to dashboard.scraperapi.com/signup and create a free account
- Copy your API key and make sure to add it to the
SCRAPER_API
environment variable
The script keeps track of a few things in memory:
- Your username and password, used to login and to create an access token. This is only used temporarily during a request itself.
- A cryptographic hash that is calculated based on your username and password.
- A Podimo access token, which is kept in memory for accessing pages after logging in.
This data is not written to the disk (unless STORE_TOKENS_ON_DISK
is set to true) and it is never logged.
Copyright 2022-2023 Thijs Raymakers
Licensed under the EUPL, Version 1.2 or – as soon they
will be approved by the European Commission - subsequent
versions of the EUPL (the "Licence");
You may not use this work except in compliance with the
Licence.
You may obtain a copy of the Licence at:
https://joinup.ec.europa.eu/software/page/eupl
Unless required by applicable law or agreed to in
writing, software distributed under the Licence is
distributed on an "AS IS" basis,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either
express or implied.
See the Licence for the specific language governing
permissions and limitations under the Licence.
If you find this tool to be helpful, please consider buying me a coffee! It is greatly appreciated!