Lainchan is a fork of [vichan](http://github.com/vichan-devel/vichan),
a great imageboard package, actively building on it and adding a lot of features and other
The leftypol imageboard is a fork of [lainchan](http://github.com/lainchan/lainchan), a fork of [vichan](http://github.com/vichan-devel/vichan), actively building on it and adding features, bug-fixes and other
improvements.
We highly recommend you read the [vichan GitHub wiki](http://github.com/vichan-devel/vichan/wiki) for a basic guide to features.
Requirements
------------
1. PHP >= 5.4 (we still try to keep compatibility with php 5.3 as much as possible)
PHP 7.0 is explicitly supported.
2. MySQL/MariaDB server
1. PHP >= 5.4. PHP 7.0 is explicitly supported. There is a PHP 8 capable branch.
2. Navigate to ```install.php``` in your web browser and follow the
prompts.
3. lainchan should now be installed. Log in to ```mod.php``` with the
3. leftypol should now be installed. Log in to ```mod.php``` with the
default username and password combination: **admin / password**.
Please remember to change the administrator account password.
@ -56,30 +53,30 @@ See also: [Configuration Basics](https://web.archive.org/web/20121003095922/http
Upgrade
-------
To upgrade from any version of Tinyboard or vichan:
This probably will break if you try and upgrade from vichan or the older (<= August 2021) leftypol versions. Ask us for migration advice if you intend to do so.
To upgrade from this repo:
Either run ```git pull``` to update your files, if you used git, or
backup your ```inc/instance-config.php```, replace all your files in place
(don't remove boards etc.), then put ```inc/instance-config.php``` back and
finally run ```install.php```.
To migrate from a Kusaba X board, use http://github.com/vichan-devel/Tinyboard-Migration
To migrate from a Kusaba X board, use http://github.com/vichan-devel/Tinyboard-Migration (untested)
Support
--------
If you find a bug, please report it.
If you need assistance with installing, configuring, or using lainchan, you may
If you need assistance with installing, configuring, or using leftypol, you may
find support from a variety of sources:
* If you're unsure about how to enable or configure certain features, make
sure you have read the comments in ```inc/config.php```.
* For support, reply to the sticky on our [/tech/](https://leftypol.org/tech/) board.
### Tinyboard support
vichan, and by extension lainchan, is based on a Tinyboard, so both engines have very much in common. These
links may be helpful for you as well:
vichan, and by extension lainchan and leftypol, is based on a Tinyboard, so both engines have very much in common. These links may be helpful for you as well:
* Tinyboard documentation can be found [here](https://web.archive.org/web/20121016074303/http://tinyboard.org/docs/?p=Main_Page).
@ -95,13 +92,13 @@ at the power users. You won't be able to run these from shared hosting accounts
Localisation
------------
Wanting to have lainchan in your language? You can contribute your translations to vichan at this URL:
Wanting to have leftypol in your language? You can contribute your translations to vichan at this URL:
lainchan makes use of [wPaint](https://github.com/websanova/wPaint) for oekaki. After you pull the repository, however, you will need to download wPaint separately using git's `submodule` feature. Use the following commands:
leftypol makes use of [wPaint](https://github.com/websanova/wPaint) for oekaki. After you pull the repository, however, you will need to download wPaint separately using git's `submodule` feature. Use the following commands:
```
git submodule init
@ -114,12 +111,12 @@ WebM support
------------
Read `inc/lib/webm/README.md` for information about enabling webm.
lainchan API
leftypol API
----------
lainchan provides by default a 4chan-compatible JSON API, just like vichan. For documentation on this, see:
leftypol provides by default a 4chan-compatible JSON API, just like vichan. For documentation on this, see:
https://github.com/vichan-devel/vichan-API/ .
License
--------
See [LICENSE.md](http://github.com/lainchan/lainchan/blob/master/LICENSE.md).