Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

178 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
project logo

Faridoon

Easily save and publish your favourite chat quotes for others to see.

Static Badge GitHub Actions Workflow Status Discord

Documentation for how to install and use Faridoon is available at https://jamesread.github.io/Faridoon/

Screenshots

Note the screenshots below contain quotes from the site that inspired this self hosted project - bash.org - which is now offline. There are several mirrors available via search engines. These quotes were used because they've been shared wildly for over 2 decades, and they're pretty funny :-)

Faridoon Mobile Phone Screenshot

Faridoon Desktop Screenshot

Getting Started

Documentation is available at: https://jamesread.github.io/Faridoon/ , the recommended installation method is via Docker, connected to a MySQL Database. Faridoon runs just fine with low system resources - 1 vCPU and a 1 GB of RAM is plenty.

Stack

  • Go service with ConnectRPC
  • Vue 3 + Vue Router + picocrank UI components
  • MySQL schema managed with sql-migrate
  • Authentication via httpauthshim (sessions; users stored in MySQL)

Features

  • Automatic highlighting of usernames.
  • Semi-intelligent removal of line breaks and weird characters.
  • User login and registration, with admins and privilege-based moderators.
  • Approval queue for guest and non-privileged submissions (reject deletes the quote).
  • Admin Settings (database cvars) for site title, voting, registration, guest add, and syntax highlighting.
  • Header links, webhooks (approval.requested), audit logs, and diagnostics.
  • YAML config for listen/database/auth; environment variables for database connectivity (and a few bootstrap values).

Faridoon is a No-Nonsense Open Source project;

  • All code and assets are Open Source (AGPL).
  • No company is paying for development, there is no paid-for support from the developers.
  • No separate core and premium version, no plus/pro version or paid-for extra features.
  • No SaaS service or "special cloud version".
  • No "anonymous data collection", usage tracking, user tracking, telemetry or email address collection.
  • No requests for reviews in any "app store" or feedback surveys.
  • No prompts to "upgrade to the latest version".
  • No internet-connection required for any functionality.

Docs

Documentation for how to install and use Faridoon is available at https://jamesread.github.io/Faridoon/

Releases

Packages

Used by

Contributors

Languages