mirror of https://github.com/TitanEmbeds/Titan.git synced 2024-12-24 14:07:03 +01:00

Create Discord server widgets for websites of all sizes! A simple to setup process for end-users. Server members may view or send messages into an embedded Discord channel.

chatbot discord discord-bot discord-py discord-py-bot discordpy embed flask titan webapp widget

Go to file

Jeremy Zhang 197750fc91 Fix bug where it would alert warning when saving custom css		2018-07-27 09:02:10 +00:00
discordbot	Implement reactions	2018-07-27 08:57:54 +00:00
webapp	Fix bug where it would alert warning when saving custom css	2018-07-27 09:02:10 +00:00
.gitignore	Remove tmp for good	2018-07-21 07:42:44 +00:00
cloud9_install.sh	Upgrade setuptools in the c9 install process	2018-07-14 23:51:08 +00:00
CONTRIBUTING.md	New cloud9 instructions and steps from websockets update	2017-09-25 00:02:05 +00:00
crowdin.yml	Update Crowdin configuration file	2018-01-27 15:07:05 -08:00
LICENSE	Create LICENSE	2017-09-08 23:37:15 -07:00
README.md	Fix gino bugs, reimplement ban and revoke cmds, enforce postgresql	2018-07-10 19:06:54 +00:00
requirements.txt	Use redis to store discord api related objects, so far messages only	2018-07-16 03:50:31 +00:00

README.md

Titan

Visit our website! https://titanembeds.com/ And get started right away!

There was a time when Discord doesn't support embedding the chat on a webpage. But with Titan, you can! It is as simple as 1, 2, 3!

Invite the bot to your server (You must have "Manage Server" permissions)
Configure the embed to your liking (toggling guest users, etc)
Copy the iframe code and paste the line in your webpage!

Features

Guest users (a quick way to invite users who do not have a Discord account)
Moderation Features (Kick & ban users by IP addresses, toggling guest users)
Discord OAuth support. (Allows those who have a discord account to access the embed)
Responsive material design! (Thanks materializecss!!)

Installation

Would you like to run your own copy of Titan Embeds? There are two parts that integrate nicely together. The webapp (website) handles the frontend and communication with the database to retrieve server messages, etc. The discordbot (bot) handles the communcation between Discord's websockets and pushing out the data to the database for the webapp. Check out the respective folder for their installation instructions.

If you happen to have a copy of Ubuntu on your server, you may head onto our Ansible Playbooks repository and perform a near-to-automatic installation of TitanEmbeds.

Database installation

To set up the database for it to work with the webapp and the discordbot, one must use alembic to migrate their databases to the current database state. To do so, please follow these instructions. PostgreSQL supports proper indexing and suitable for Titan needs. For this reason, Titan only supports using a PostgreSQL database.

Install alembic with Python 3.5's pip pip install alembic
Change your directory to the webapp where the alembic files are located cd webapp
Clone alembic.example.ini into your own alembic.ini file to find and edit the following line sqlalchemy.url to equal your database uri. See here if you need help understanding how database uri works in SQLalchemy.
In your terminal, run alembic upgrade head to upgrade your database tables to the current version on git. As long as there are only INFO messages and no errors, you should be fine.
Check your database tables to see if they are created. If so, you have finished migrating your database! Remember to run Step 4 every now and then just in case if there are database updates. (Presumably on every git pull).

Join us!

Come and talk with us at our very own Discord server! We offer support too!

Translate for us!

Visit us over at our CrowdIn project and teach Titan how to speak your language!

Disclaimer

This project is never to be used as a replacement for Discord app. It is used in conjunction for a quick and dirty Discord embed for websites. Some uses are via shoutboxes, etc.