Lightweight and efficient imageboard
Go to file
Trevor Slocum 555987ae8d Update donation note
Resolves #149.
2020-12-07 08:05:41 -08:00
css Add style switcher 2020-08-20 15:44:44 -07:00
inc Fix hiding embed field 2020-12-05 18:02:24 -08:00
js Add style switcher 2020-08-20 15:44:44 -07:00
locale Update translations 2020-11-30 17:12:28 -08:00
res Removing placeholder files 2010-11-29 16:39:16 -08:00
src Removing placeholder files 2010-11-29 16:39:16 -08:00
thumb Removing placeholder files 2010-11-29 16:39:16 -08:00
.gitignore Use cURL instead of file_get_contents, mime_content_type instead of shell_exec (#38) 2017-12-14 14:27:26 -08:00
.htaccess Add support for MP4 uploads 2020-06-02 16:15:04 -07:00
LICENSE add JSON support 2020-08-11 22:04:09 +02:00
README.md Update donation note 2020-12-07 08:05:41 -08:00
favicon.ico first commit 2009-09-19 19:53:15 -07:00
imgboard.php Fix hiding embed field 2020-12-05 18:02:24 -08:00
lock.png Support locking threads 2020-07-31 16:16:37 -07:00
settings.default.php Update default SQLite database path 2020-11-30 17:04:46 -08:00
sticky.png Add sticky threads 2015-08-21 00:45:01 -07:00
swf_thumbnail.png Add optional SWF support, make picture support optional, add text board mode 2014-07-05 12:27:18 -07:00
video_overlay.png Add optional WebA and WebM support 2014-06-24 12:51:22 -07:00

README.md

TinyIB - Lightweight and efficient imageboard

Translate Donate

See TinyIB Installations for demos.

Features

Got database? Get speed. Use MySQL, PostgreSQL or SQLite for an efficient set-up able to handle high amounts of traffic.

No database? No problem. Store posts as text files for a portable set-up capable of running on virtually any PHP host.

Not looking for an image board script? TinyIB is able to allow new threads without requiring an image, or even disallow images entirely. See the Text Board Mode wiki page for instructions.

  • GIF, JPG, PNG, SWF, MP4 and WebM upload.
  • YouTube, Vimeo and SoundCloud embedding.
  • CAPTCHA
  • Reference links. >>###
  • Delete posts via password.
  • Report posts.
  • Block keywords.
  • Management panel:
    • Administrators and moderators use separate passwords.
      • Moderators are only able to sticky threads, lock threads, delete posts, and approve posts when necessary. (See TINYIB_REQMOD)
    • Ban offensive/abusive posters across all boards.
    • Post using raw HTML.
    • Upgrade automatically when installed via git. (Tested on Linux only)
  • Translations:
    • Chinese
    • Dutch
    • French
    • German
    • Italian
    • Korean
    • Norwegian
    • Spanish (Mexico)

Donate

Please consider supporting the continued development of TinyIB.

If you make a donation and there is a certain feature you'd like to see added to TinyIB, send me an email. I can't promise that I will implement the feature right away, however I will keep your support in mind.

Install

  1. Verify the following are installed:
    • PHP 5.5+
    • GD Image Processing Library
      • This library is usually installed by default.
      • If you plan on disabling image uploads to use TinyIB as a text board only, this library is not required.
  2. CD to the directory you wish to install TinyIB.
  3. Run the command:
    • git clone https://gitlab.com/tslocum/tinyib.git ./
  4. Copy settings.default.php to settings.php
  5. Configure settings.php
    • When setting TINYIB_DBMODE to flatfile, note that all post, report and ban data are exposed as the database is composed of standard text files. Access to ./inc/database/flatfile/ should be denied.
    • When setting TINYIB_DBMODE to pdo, note that only the MySQL and PostgreSQL databases drivers have been tested. Theoretically it will work with any applicable driver, but this is not guaranteed. If you use an alternative driver, please report back.
    • To require moderation before displaying posts:
      • Set TINYIB_REQMOD to files to require moderation for posts with files attached.
      • Set TINYIB_REQMOD to all to require moderation for all posts.
      • Moderate posts by visiting the management panel.
    • To allow video uploads:
      • Ensure your web host is running Linux.
      • Install mediainfo and ffmpegthumbnailer. On Ubuntu, run sudo apt-get install mediainfo ffmpegthumbnailer.
      • Add desired video file types to $tinyib_uploads.
    • To remove the play icon from .SWF and .WebM thumbnails, delete or rename video_overlay.png
    • To use ImageMagick instead of GD when creating thumbnails:
      • Install ImageMagick and ensure that the convert command is available.
      • Set TINYIB_THUMBNAIL to imagemagick.
      • Note: GIF files will have animated thumbnails, which will often have large file sizes.
    • To use TINYIB in another language:
      • Set TINYIB_LOCALE to a language code found in locale/.
      • Ensure you are running PHP 5.4+.
  6. CHMOD write permissions to these directories:
    • ./ (the directory containing TinyIB)
    • ./src/
    • ./thumb/
    • ./res/
    • ./inc/database/flatfile/ (only if you use the flatfile database mode)
  7. Navigate your browser to imgboard.php and the following will take place:
    • The database structure will be created.
    • Directories will be verified to be writable.
    • The board index will be written to TINYIB_INDEX.

Moderate

  1. If you are not logged in already, log in to the management panel by clicking [Manage].
  2. On the board, tick the checkbox next to the offending post.
  3. Scroll to the bottom of the page.
  4. Click Delete with the password field blank.
    • From this page you are able to delete the post and/or ban the author.

Update

  1. Obtain the latest release.
    • If you installed via Git, run the following command in TinyIB's directory:
      • git pull
    • Otherwise, download and extract a zipped archive.
  2. Note which files were modified.
    • If settings.default.php was updated, migrate the changes to settings.php
      • Take care to not change the value of TINYIB_TRIPSEED, as it is used to generate secure tripcodes, hash passwords and hash IP addresses.
    • If other files were updated, and you have made changes yourself:
      • Visit GitLab and review the changes made in the update.
      • Ensure the update does not interfere with your changes.

Migrate

TinyIB includes a database migration tool.

While the migration is in progress, visitors will not be able to create or delete posts.

  1. Edit settings.php
    • Set TINYIB_DBMIGRATE to the desired TINYIB_DBMODE after the migration.
    • Configure all settings related to the desired TINYIB_DBMODE.
  2. Open the management panel.
  3. Click Migrate Database
  4. Click Start the migration
  5. If the migration was successful:
    • Edit settings.php
      • Set TINYIB_DBMODE to the mode previously specified as TINYIB_DBMIGRATE.
      • Set TINYIB_DBMIGRATE to a blank string ('').
    • Click Rebuild All and ensure the board still looks the way it should.

Support

  1. Ensure you are running the latest version of TinyIB.
  2. Review the open issues.
  3. Open a new issue.

Translate

Translation is handled online.

Contribute

Note: Please do not submit translations as pull requests. See above.

  1. Read the GitLab Forking Workflow.
  2. Fork TinyIB.
  3. Commit code changes to your forked repository.
  4. Submit a pull request describing your modifications.