Python web board system (textboard, CGI, flatfile) http://4x13.net/bbs
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.
 
 
 
 
 
153 a6dc1b52ba
Minor bugfixes; increased comment length on page 1
1 vuosi sitten
admin big overhaul 3 vuotta sitten
css Update vba.css 2 vuotta sitten
html Update head.html 2 vuotta sitten
img cleanup 4 vuotta sitten
js themes 3 vuotta sitten
notes big overhaul 3 vuotta sitten
threads big overhaul 3 vuotta sitten
.gitignore big overhaul 3 vuotta sitten
LICENSE Initial commit 4 vuotta sitten
README.md Update README.md 2 vuotta sitten
admin.py big overhaul 3 vuotta sitten
backlink.py Update backlink.py 2 vuotta sitten
bans.py Update bans.py 2 vuotta sitten
bans.txt Create bans.txt 2 vuotta sitten
index.py3 Minor bugfixes; increased comment length on page 1 1 vuosi sitten
ips.txt big overhaul 3 vuotta sitten
ips2.txt big overhaul 3 vuotta sitten
list.txt big overhaul 3 vuotta sitten
mod.py Update mod.py 2 vuotta sitten
settings.txt big overhaul 3 vuotta sitten
spam.txt Create spam.txt 2 vuotta sitten
tripcode.py3 big overhaul 3 vuotta sitten
webtools.py Update webtools.py 2 vuotta sitten

README.md

iyagi

Python web board system (textboard, CGI, flatfile)

Inspired by Kareha, Shiichan, Tablecat BBS, and others.

Requires python 3.6+, collections (for defaultdict)

  1. Features
  2. Screenshots
  3. Installation
  4. Settings / config
  5. To-do

1. Features

The script iyagi (이야기, “chat”) is approaching a nicer cleaner refactor with more features. But it works, and it can do some things that other boards can’t.

It currently has the following features:

  • Works well out of the box and friendly ./settings.txt
  • Thread replying with/without bumps (age/sage)
  • Tripcodes (pseudo-registration)
  • 4x13 and 0ch themes, with JS styleswitcher
  • [spoiler], [code], [yt] (YouTube) BBcode tags
  • Backlinking, to keep track of sub-threads
  • very weak spam detection
  • Permasage, Lock, and Sticky
  • Vanilla
  • IP logging
  • Atom feeds for recent posts / threads
  • Slick NoSQL

2. Screenshots


Frontpage, in 0ch and 4x13 themes



A thread with no comments, showing off the reply window. “Bump” can be unchecked, which preserves the thread’s order in the index.



Ascii art, using [aa][/aa] tags (out for repairs)



Code, using [code][/code] tags




Locked, stickied, dead threads. Locked threads cannot be posted in, stickied threads always stay at the top of the board, dead threads cannot be bumped.

3. Installation

Installation couldn’t be easier. Just download the repo and give the BBS directory and its contents read/write privileges with the web daemon. Then, open settings with your favorite text editor, and from there, confirm your settings.

Moderation is currently done by managing text files in a directory; the default directory is “./threads/". You need to have at least one valid thread on the board to enable posting; if you need to initialize the board, create a folder called “./threads/” that’s readable/writable by the web daemon, and in there create a file called 0.txt. In your iyagi directory, create a file called “list.txt”.

list.txt contents:
0 >< 0 >< 0 >< 0 >< 0
  
0.txt contents:
0
0 >< 0 >< 0 >< 0

Then, try posting another thread from the page to confirm that your board works. To get rid of that first thread, remove its entry from list.txt and remove 0.txt from the thread directory. To edit threads/posts, find a thread’s filename in your web browser or list.txt, then just modify it in a text editor.

If you want to lock a thread, change the last number in its row, in list.txt, to “1”. To sticky, “2”. To stickylock, “3”. To kill, “4”. Then, open the thread (its_unix_time.txt in ./threads/) and add “><”, followed by that same value to the title line.

Clunky, but it works for now :)

4. Settings / config

settings.txt

    1. board name
    1. board url
    1. mod username
    1. mod password (using hash generated from ./tripcode.py)
    1. theme (unused)
    1. thread storage (./threads)
    1. thread list (./list.txt)
    1. full URL
    1. time zone
    1. post IP log (ips.txt)
    1. thread IP log (ips2.txt)
    1. show recent - 8
    1. show replies - 3

index.py

  • settings = ./settings.txt
  • bad_words = ["bad", "words", "go", "here"]

bans.py

"1.2.3.4":"spam",
"2.2.2":"a wildcard for 2.2.2"
".": "ban absolutely everyone from posting"
}

5. To-do

Your comments/contributions would be appreciated

Here’s what I’d like to bring to future versions of IYAGI

  • More stylesheets
  • better refactoring
  • Admin panel, anti-spam filters
  • thread / index pagination
  • More JS stuff, maybe?

Possible bonus features:

  • User storable capcodes
  • ?????