Kiramoji is a modified version of Kareha. Kareha is an anonymous message board, popular in Japan. No registration is required to post.
The concept of anonymous messages helps to focus on the conversations themselves, rather than on their authors. Should you wish to, you can, however, use the nickname everyone knows you by.
Kiramoji can operate in two modes, as an image board or a text board.
Kareha itself is an incredibly impressive achievement, many features are pushing Perl's boundaries, mostly using core dependencies and not a single C extension.
This is a modified version of The original Kareha, written by Dag Ågren/WAHa.06x36 in Perl. Later, it was further modified by hotaru2k3, fixing WebKit/related issues, as well as adding some minor changes.
This fork is based on the above mentioned modified version, with a few changes added here and there and it is probably the most recent version out there.
I am by no means a Perl expert, so pull requests and issues are welcome!
This is the version that runs on our KiraMoji page, feel free to stop by and say hi!
There exists an older PSGI version here based on 3.1.4.
Similarly to Kareha's license, this mod is released into the public domain.
- Added Spanish template (thanks to Guilevi)
- Templates are modified to have some ARIA attributes, edit fields in particular, as well as some links are properly labelled for screen readers.
- If the board operates in paged mode, page navigation controls are displayed at the bottom of the page for text boards.
- param-related bugs have been fixed, so there are no CGI warnings anymore.
- Added a dice roller for the link field. The syntax is: size d NumberOfDice +/-modifier (optional) a/d (ascending/descending sorting, optional). (for example 6d5+100d will roll 5 6-sided die, add 100 and sort the result in descending order)
- Switched the encoding to UTF-8. This means that messages, templates and the config file are expected to be encoded using UTF-8.
- Swapped out the SillyName generator to an adjective/noun-based one, based on https://github.polettix.it/ETOOBUSY/2020/01/28/generate-name/
- The Japanese template does not have the ARIA fixes nor pagination, as I unfortunately do not speak Japanese. Pull requests are welcome!
This is a modified version of Kareha. some bugs that can cause xhtml errors have been fixed, and a few minor features have been added.
First and foremost, you will need a webserver. Apache is a good choice, or Caddy if you prefer something more modern and awesome.
When you download/build Caddy, you will need the http.cgi middleware. Add it in the plugins section.
When building Caddy 2 via xcaddy, you can use https://github.com/aksdb/caddy-cgi instead. See examples on the same Github page.
Kiramoji does not require much, it should work on most distributions out of the box. The only exceptions are Perl's CGI and utf8::all modules. You can use a package manager, such as cpan or cpanminus to install them.
WARNING: Your version of Perl must be 5.24 or newer.
In case your server does not come with Perl by default, you can install it via your package manager, or perlbrew. Refer to its documentation for help, usually man packageManagerName will do the trick.
- git clone https://github.com/Flameborn/Kiramoji
- Copy everything to your cgi-bin directory.
- Make sure kiramoji.pl and admin.pl has execute permission (+x).
- Make sure that the main Kiramoji directory and the res directory are writable (+w).
- Copy everything from one of the mode directories, either message or image, depending on what kind of board you wish to have.
- Modify config.pl, in particular uncomment and change ADMIN_PASS_ and SECRET.
- Open YourDomain.com/kiramoji.pl to generate the index page.
Enjoy!
You can install Kiramoji in multiple directories (see the installation steps above), or you can symlink the files. The Lndir command is quite useful to do this.
Tripcodes are special hashes of a poster, they are generally used for authenticity. You can use them in the name field when posting. For example:
YourName#password (less secure)
Or:
YourName##password (more secure, based on the SECRET you've changed in the config file.)
Capcodes are defined in config.pl, and they are used to replace shown tripcodes with arbitrary text. For example: !!S5RPiYbB could be replaced with Admin.
Sage is a way to post without bumping a thread, i.e. moving it to the top of the list. You can post using sage by entering sage in the Link field.
Kiramoji is now using UTF-8. Please make sure that your configuration file config.pl is encoded as UTF-8.
Kiramoji is now using UTF-8. Please make sure that your template file templates.pl for your language (e.g. JP) is encoded as UTF-8.
You need to edit _kiramoji.pl and change the line:
BEGIN { require 'templates.pl'; }
to reflect the new templates filename.
An alternative method is to rename whatever templates file you wish to have to templates.pl. Make sure you have a backup version of the old templates.pl file, in case you wish to switch back to the original.