More flags for r/banter
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
not manx 2a5ac4b592
Use &aux for (conf)
3 years ago
env Uhh 3 years ago
src Use &aux for (conf) 3 years ago
.gitignore Use &aux for (conf) 3 years ago
LICENSE Create LICENSE 3 years ago Fix CSS thing 3 years ago
bantflags.meta.js Improve update thread functions 3 years ago
bantflags.user.js Fix CSS thing 3 years ago


A user script and backend enabling user created flags on bant, originally based on extraflags.

Install bantflags


The userscript uses of GM_xmlhttpRequest to get and post flags with the backend . A user's flags are stored between pages using GM_setValue and GM_getValue, or their GreaseMonkey4 equivalents.

Old versions of GreaseMonkey will be able to recieve updates to the script through the @updateURL and @downloadURL directives, though these were depricated sometime in GreaseMonkey 3.x and updates are only checked from the location the script was downloaded from so be careful where you upload links.

On self hosting, changing back_end to your domain should be all you need to do, but don't take this as fact.

The userscript has been designed specifically to target ECMAScript 2015 (ES6), making liberal use of arrow functions, and const/let declarations. Update your hecking browser.



  • I use SBCL
  • Some mysql, I use Mariadb
  • Quicklisp


  • hunchentoot
  • hunchenhelpers, my hunchentoot helper library (yes I'm proud of the name)
  • clsql
  • jonathan, the JSON encoder/decoder
  • cl-ppcre


  1. clone the project
  2. Symlink src/ to your ~/quicklisp/local-projects
  3. Move src/ to src/ and change it to whatever your settings are.
  4. Initialise the database by doing something like mysql << env/database.sql, This will create all the tables you will need, plus an entry for the `empty flag`
  5. Type the following into your repl:
(ql:quickload :bantflags)
  1. To use bantflags as a Systemd service, I have included an example service and an init.el file for the service to run, since Systemd will automatically kill it if you just eval bantflags:main.

You will almost certainly have several issues building clsql, the database connector used. I've written a blog post on some of the issues I've encountered personally, but there's no guarantee it'll work. Piece of shit.


Tables look like this:


id post_nr board
1 12345 bant
2 56789 bant


id flag
1 patchouli
2 chen


id post_nr flag
1 1 1
2 1 2
2 2 2

where post_nr and flag in postflags are the id fields in their respective tables.


The backend exposes three endpoints for the userscript to get and post flags. Flags themselves are hosted from flags/ which is www-root/flags/ from config.lisp on the filesystem

route purpse
/api/get Get flags using post numbers in the thread
/api/post Add flags to the database
/api/flags List the flags we support
/flags/* The flag images


You will get an error like =Recursive lock attempt #<SB-THREAD:MUTEX "global-message-log-lock" owner: #<SB-THREAD:THREAD "hunchentoot-worker-" RUNNING {1001DED5E3}>>.= if you try and log to a file that doesn't exist / you don't have permissions to read/write.