/libmedium

An Alternative Medium Frontend | Development continues at: https://git.batsense.net/realaravinth/libmedium

Primary LanguageHTMLGNU Affero General Public License v3.0AGPL-3.0

LibMedium

Privacy-focused proxy for medium.com

Awesome Humane Tech Build dependency status codecov

Status

Usable. Should you run into a HTTP 500 Internal Server Error, please file a bug report with the URL of the post you were trying to read and the git commit hash of the build. Git commit hash can be obtained from /api/v1/meta/build.

This proxy works by interacting with Medium's undocumented(probably private but unauthenticated) API. So I've had to make assumptions and tweak API schematics as I run into errors.

Features

  • proxy images
  • proxy GitHub gists
  • render posts
  • syntax highlighting for gists
  • user pages(WIP)
  • RSS feeds

Why?

Knowledge is the true wealth of humanity. If it weren't for our ancestors, who chose to pass down their knowledge and experiences, we would still be a primitive species. Whatever advancement that we as a species have achieved is because we chose to share information.

To put a paywall on knowledge like that is both obscene and goes against the very nature of humanity.

It is possible to run a sustainable publication business while still respecting freedom. LWN.net is one of my favourite publications that has been around forever. So it is possible. I hope medium.com comes up with other, non-harmful ways to run a sustainable business.

Instances

Instance Country Provider Host
https://libmedium.batsense.net India Airtel @realaravinth
https://md.vern.cc US Hetzner ~vern
http://md.vernccvbvyi5qhfzyqengccj7lkove6bjot2xhh5kajhwvidqafczrad.onion/ N/A Hetzner ~vern
http://vernaqj2qr2pijpgvf3od6ssc3ulz3nv52gwr3hba5l6humuzmgq.b32.i2p/ N/A Hetzner ~vern
https://medium.hostux.net France Gandi hostux
https://md.xbdm.fun Germany Hetzner Hosted by xbdm
https://libmedium.fascinated.cc Germany Behind Cloudflare @RealFascinated
https://libmedium.frontendfriendly.xyz US Hetzner Frontend Friendly 
           |

Deploy with Docker

  1. Grab ./config/default.toml and make necessary changes

  2. AMD64 pre-compiled images are available on DockerHub.

docker run -d \
  -v ./config/default.toml:/etc/libmedium/config.toml \
  -p 8082:7000 \
  --restart always \
  --name libmedium \
  realaravinth/libmedium

If you are on a different architecture, run make docker and then run the above command.

make docker

Deploy with Docker-Compose

  1. apt install git

  2. git clone https://github.com/realaravinth/libmedium.git medium

  3. nano config/default.toml

  4. nano docker-compose.yml

  5. docker-compose up -d

Go to your website: http://localhost:8082

Inspired by Scribe - An Alternative Medium Frontend