/web

THIS REPOSITORY IS JUST MIRROR! Main development repository is https://codeberg.org/Freedium-cfd/web

Primary LanguagePython

Freedium: Your paywall breakthrough for Medium!

"Buy Me A Coffee"

FAQ

What is happened to GitHub organization?

Our whole Github organization is not public for now. Reddit community, that was beginning all of that unfourtunately also gone. So we have moved to Codeberg

Why did we create Freedium?

In mid-June to mid-July 2023, Medium changed their paywall method, and all old paywall bypass methods we had stopped working. So I became obsessed with the idea of creating a service to bypass Medium's paywalled posts. Honestly I am not a big fan of Medium, but I sometimes read articles to improve my knowledge.

How does Freedium work?

In the first version of Freedium, we reverse-engineered Medium.com's GraphQL endpoints and built our own parser and toolkits to show you unpaywalled Medium posts. Unfortunately, Medium closed this loophole and nowadays we just pay subscriptions and share access through Freedium. Sometimes we got a bugs because of the self-written parser, but we are working to make Freedium bug-free.

What language are being used?

We use Python, with Jinja template builder, and some JS magic in Frontend :)

Wow! I would like to contribute to Freedium. How can I do that?

We need volunteers who have Medium subscriptions because we might get banned by Medium. And if you developer you can start from the this (https://codeberg.org/Freedium-cfd/web) repository.

Plans, future?

Speed up Freedium, and probably create open source Medium frontend in next life

Tech stack:

  • FastAPI, Gunicorn, Unicorn as worker,
  • Tailwinds CSS v3
  • Dragonfly (Redis like key-value database)
  • Jinja2
  • Python 3.9+
  • Caddy
  • Sentry

Local run:

Requirements:

  • Docker
  • git
  • Linux. Officially, we can't guarantee that Freedium will work on other OS.

We need configure our Freedium instance. Copy .env_template to .env configuration file and set values, required for you.

git clone https://codeberg.org/Freedium-cfd/web/ ./web --depth 1
cd ./web
cp .env_template .env
# do some changes in .env, if you want
sudo docker-compose -f docker-compose-dev.yml up

And now you can access local instance of Freedium by opening browser and type http://localhost:6752.