Skip to content

beucismis/ozgursozluk

Repository files navigation

ozgursozluk-logo

This project is free alternative Ekşi Sözlük front-end focused on privacy and performance. Made with <3 on the T61. Contributions are most welcome! Offical instance: https://ozgursozluk.org

PyPI - Version PyPI - Version PyPI - Python Version GitHub License GitHub Actions Workflow Status Dynamic JSON Badge

Features

  • No JavaScript Required – works perfectly without JS
  • Docker Support – easy deployment and setup
  • Topic Search – quickly find relevant discussions
  • View Topics, Entries & Authors – browse content and contributors
  • Gündem & Debe Page Support – full support for special pages
  • Hide Displaying – favorite count, author and entry date
  • Entry Images - display images directly from the source
  • 10+ Built-in Themes – customize the look with 10+ themes
  • Self-Hosted, Ad-Free & Lightweight – fast, simple, and private on your server
  • Responsive Design – optimized for mobile and small screens

Preview

Running

git clone https://github.com/beucismis/ozgursozluk
cd ozgursozluk/
pip install .
flask --app ozgursozluk.main:app run

Running with Docker

git clone https://github.com/beucismis/ozgursozluk
cd ozgursozluk/
docker build -t ozgursozluk .
docker run -d -p 5000:5000 --name ozgursozluk ozgursozluk

See also, https://github.com/beucismis/ozgursozluk/wiki/Main

Usage

Once the service is running, you can access the API at http://localhost:5000.

Environment Variables

Variable Default Value
SECRET_KEY token_hex(24)
FLASK_RUN_HOST 127.0.0.1
FLASK_RUN_PORT 5000
EKSI_SOZLUK_BASE_URL https://eksisozluk.com

Development

This project uses Hatch for project management.

  1. Install dependencies:

    pip install hatch
    hatch env create
    
  2. Run development server: (with hot-reloading)

    hatch run dev
    
  3. Format code:

    hatch run format
    
  • The ASGI app is defined as app in src/ozgursozluk/main.py.
  • When installed as a package, you can launch it using gunicorn, uvicorn, hypercorn or any compatible ASGI tool.

Redirection

Redirector browser extension is recommended for use. Configuration:

Description: Redirector
Example URL: https://eksisozluk.com/linux--32084
Include pattern: https://eksisozluk.com/*
Redirect to: https://ozgursozluk.org/$1
Pattern type: Wildcard
Pattern Description: https://ozgursozluk.org/linux--32084
Example result: https://ozgursozluk.org/linux--32084

License

This project is licensed under WTFPL for details, check LICENSE file.

Sponsor this project

Packages

 
 
 

Contributors 7