summaryrefslogtreecommitdiff
path: root/README.md
diff options
context:
space:
mode:
authorilotterytea <iltsu@alright.party>2025-05-02 17:43:50 +0500
committerilotterytea <iltsu@alright.party>2025-05-02 17:43:50 +0500
commit9c7e8c24f8273f70d743ae44034a01da352a88e9 (patch)
tree91ebac1a6b4103038a6c7cec75cd61c7996ae529 /README.md
parent65eb2ff002015f066f47495bbd41e0412e9071d7 (diff)
upd: readme
Diffstat (limited to 'README.md')
-rw-r--r--README.md77
1 files changed, 74 insertions, 3 deletions
diff --git a/README.md b/README.md
index b64fa94..a81ae18 100644
--- a/README.md
+++ b/README.md
@@ -1,12 +1,83 @@
-# AlrightTV
+# ![](/icon.png) TinyEmotes
-a free, easy-to-install web emote provider for Twitch chats!
+Free, easy-to-install custom emote provider for IRC (and Twitch) platforms!
+The main goal of the project is to replicate full functionality of other emote providers *(7TV, BetterTTV and FrankerFaceZ)* and make it free for everyone. The design is inspired by booru imageboards.
-## Prerequisites
+## Features
+
++ Emote upload (GIF/WebP support, automatic resizing)
++ Moderation system (Reports, emote approval)
+
+> The project is in public beta. See [TODO list](https://github.com/users/ilotterytea/projects/11) for upcoming features.
+
+## Public TinyEmotes Instances
+
+| URL | Description | SFW/NSFW | Category |
+|-----|-------------|----------|----------|
+| [alright.party](https://alright.party) | Official TinyEmotes instance | NSFW | Mixed
+
+> PR if you know any instances running TinyEmotes.
+
+## Software supporting TinyEmotes
+
++ [Tinyrino](https://github.com/ilotterytea/tinyrino) - a Chatterino fork made by the author of TinyEmotes.
+
+> PR if you know any software supporting TinyEmotes.
+
+## Installation guide
+
+### Prerequisites
+ PHP >= 8.3
++ ImageMagick
+ MySQL/MariaDB
+### Step-by-step
+
+1. Clone the repository.
+2. Import `database.sql` to your database.
+3. Copy `src/config.sample.php` to `src/config.php` and set it up.
+4. Use reverse proxy *(Nginx, Apache, etc.)* for the project. See [configuration examples](#reverse-proxy-configurations).
+5. ???
+6. Profit! It should work.
+
+### Reverse proxy configurations
+
+<details>
+<summary>Basic Nginx configuration</summary>
+
+```nginx
+server {
+ server_name tinyemotesinstance.com;
+
+ root /www/tinyemotesinstance/public;
+ index index.php;
+
+ location / {
+ try_files $uri $uri/ /index.php?$query_string;
+ }
+
+ location ~ \.php$ {
+ include fastcgi_params;
+ fastcgi_pass unix:/run/php/php-fpm.sock;
+ fastcgi_index index.php;
+ fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
+ }
+
+ location ~* \.(js|css|png|jpg|jpeg|gif|webp|ico)$ {
+ expires 6M;
+ access_log off;
+ add_header Cache-Control "public";
+ }
+
+ location ~ /\. {
+ deny all;
+ }
+}
+```
+
+</details>
+
## License
This project is under MPL-2.0 license. See [LICENSE](/LICENSE) \ No newline at end of file