Jack

Multi purpose telegram bot written in MoonScript/lua and licenced under the GNU General Public License.

Public bot

Website

Table of Contents

• Setup
• Ranks
• Telegram Cli
• Database
• Plugins
• Support and development
• Special thanks to
• Collaborators
• Other projects

Setup

Clone Jack !

cd $HOME
git clone https://github.com/Imandaneshi/jack-telegram-bot.git
cd jack-telegram-bot

install it!

chmod +x install.sh
./install.sh

Manual installation

Add your bot token in config.moon

telegram_api_key: "Your bot token here"

Add your telegram id to admins table in config.moon

admins: {
    110626080
    123456789
    --your id
  }

Run it !

chmod +x run.sh
./run.sh

options

Use ./run.sh --help for available options

Ranks

Ranks	Permissions
Admin	Has access to everything
Premium	Has access to premium feature
Normal user	Has access to public feature
Blacklisted	Bot will ignore blacklisted users

Telegram cli

If it's first time you are installing telegram-cli

You should have libreadline-dev libconfig-dev libssl-dev lua5.2 liblua5.2-dev libevent-dev libjansson-dev libpython-dev make installed

You can install them by

 sudo apt-get install libreadline-dev libconfig-dev libssl-dev lua5.2 liblua5.2-dev libevent-dev libjansson-dev libpython-dev make

Install telegram-cli using ./install.sh

Run it

./tg.sh

Enter your phone number and conformation code

And uncomment plugin telegramCli in config.moon

You can change port in tg.sh

You can send commands to telegram-cli using your api bot

Few examples

#tg msg user#id123456789 <text>
#tg msg channel#id123456789 <text>
#tg msg chat#id123456789 <text>
#tg resolve_username username
#tg chat_del_user chat#id123456789 user#id12345678

Telegram CLI Commands

Database

Jack uses redis as database

Here are the datas

Chats

bot:chats > List of all chats(groups,supergroups,privates)

bot:privates > List of all private chats

bot:groups > List of all groups

bot:supergroups > List of all supergroups

bot:inline_users > List of all inline users

bot:callback_users > List of all callback users

chat_id info

bot:chats:chat_id

1. title
2. type

user_id info

bot:users:user_id

1. first_name
2. last_name
3. username

These info will be updated on each msg

bot:total_inline_from_user:msg.from.id >

bot statistics

bot:total_messages > Number of total msgs bot received

bot:total_inlines > Number of total inline requests

bot:total_callbacks > Number of total callback requests

chat_id msg statistics

bot:total_chat_msgs:chat_id > Number of total msgs bot received in chat_id

"bot:total_users_msgs_in_chat:chat_id:user_id" > Number of total msgs bot received in chat_id from user_id

chat_id members

bot:chatchat_id > list of chat_id members

How to backup,restore,secure,stablize redis DB

Plugins

Plugins list

• 9gag
• Admin
• Anime
• Bing
• Calculator
• Cat
• Chatter
• Code
• Commit
• Currency
• Dogify
• DuckGo
• Echo
• Giphy
• Github
• Google
• Help
• Imdb
• Instagram
• Ipinfo
• Lastfm
• Linkshortener
• lmgtfy
• Location
• Me
• Meme
• Moon
• Poll
• Qrcode
• Reactions
• Reddit
• Remind
• Set
• Shell
• Slap
• Spotify
• Stats
• Sticker
• Talk
• Telegram-Cli
• Time
• Translate
• Time
• Translate
• Urban dictionary
• Weather
• Webshot
• Who
• Wikipedia
• Youtube

9gag

Send random image from 9gag

Listed	Requires API KEY	Enabled by default	inline
Y	N	Y	Y

Commands

/9gag

Admin

Plugin for admins

Listed	Requires API KEY	Enabled by default	inline
N	N	Y	Y

Commands

/bot

Returns Bot status

/admin reload

Reloads bot

/plugins <Plugin_name> <chat_id> <true|false>

True will disable plugin <Plugin_name> on chat <chat_id>

/blacklist <user_id>

This command will blacklist <user_id>

Can also be used by reply

/bc <chat_id> <text>

this command will send <text> to <chat_id>

Markdown is enabled

use @channel_username for sending msgs to channels

/broadcast <msg>

This command will send msg to all chats

/editmsg <new msg>

Edit message

Use in reply

Anime

Anime plugin (hummingbird.me)

Listed	Requires API KEY	Enabled by default	inline
Y	N	Y	Y

Commands

/anime search <anime name>

For searching

/anime pic <query>

Will search for query

/anime pic

Will send random anime pic

Bing

Bing Search

Listed	Requires API KEY	Enabled by default	inline
Y	Y	N	Y

Commands

/bing <terms>

Calculator

Returns solutions to math expressions

Listed	Requires API KEY	Enabled by default	inline
Y	N	Y	Y

Commands

/calc <expression>

Cat

Returns a cat

Listed	Requires API KEY	Enabled by default	inline
Y	O	Y	Y

Commands

/cat

Chatter

Talk to bot in English !

Listed	Requires API KEY	Enabled by default	inline
Y	N	Y	N

Commands

bot_first_name, <text>

bot_username, <text>

jack, How are you ?

@jackbot, How are you ?

you can also trigger chatter plugin by talking to bot in private or replying on of its messages in groups

Code

Send the code in image format with support for highlighter.

Listed	Requires API KEY	Enabled by default	inline
Y	Y	N	N

Commands

/code <language> <code>

Commit

Send the a commit.

Listed	Requires API KEY	Enabled by default	inline
Y	N	N	Y

Commands

/commit

Currency

Currency rate converter

Listed	Requires API KEY	Enabled by default	inline
Y	N	Y	Y

Commands

/cash <amount> <from> to <to>

Returns exchange rates for various currencies.

Dogify

Create a doge image with you words

Listed	Requires API KEY	Enabled by default	inline
Y	N	Y	N

Commands

/dogify <your/words/with/slashes>

DuckGo

DuckDuckGo search

Listed	Requires API KEY	Enabled by default	inline
Y	N	N	Y

Commands

/duckduckgo <terms>

/duckgo <terms>

Echo

Returns text

Listed	Requires API KEY	Enabled by default	inline
Y	N	Y	Y

Commands

/echo <text>

Markdown is enabled

Fortune

Linux Fortunes

Listed	Requires API KEY	Enabled by default	inline
Y	N	N	Y

Commands

/fortunes

Get

Retrieves variables saved with /set

Listed	Requires API KEY	Enabled by default	inline
Y	N	Y	N

Commands

/return (value_name)

Giphy

Returns a GIF from giphycom!

Listed	Requires API KEY	Enabled by default	inline
Y	Y	Y	N

Commands

/giphy

Returns a random GIF

/giphy <query>

Returns a GIF about

Github

Returns info about GitHub repo

Listed	Requires API KEY	Enabled by default	inline
Y	N	Y	Y

Commands

/github <repo>

/gitrepo SEEDTEAM/TeleSeed

Google search

Google search

Listed	Requires API KEY	Enabled by default	inline
Y	Y	Y	Y

Commands

/google <terms>

/g <terms>

Greeting

About and greeting

Listed	Requires API KEY	Enabled by default	inline
Y	N	Y	N

Commands

/about

Info about your bot

Hi bot_first_name

Bye bot_first_name

Help

Returns info about other plugins

Listed	Requires API KEY	Enabled by default	inline
N	N	Y	Y

Commands

/help

Will return a short list of plugins

/help all

Will return full list of plugins with their commands

/help <plugin_name>

Will return info about that plugin

IMDB

Returns Info about movie from IMDB and its poster

Listed	Requires API KEY	Enabled by default	inline
Y	N	Y	Y

Commands

/imdb

Instagram

Search users on instagram

Listed	Requires API KEY	Enabled by default	inline
Y	Y	N	Y

Commands

/insta <username>

Return user info

IP info

Returns Given IP or domain info

Listed	Requires API KEY	Enabled by default	inline
Y	Y	Y	Y

Commands

/ip <IP|domain>

lastfm

Lastfm

Listed	Requires API KEY	Enabled by default	inline
Y	Y	Y	Y

Commands

/lastfm

Returns what you are or were last listening to

/lastfm <username>

Returns what is or was last listening to

/lastfm set <username>

Will set your username

/lastfm rem

Will remove your username

Link shortener

Returns Shorten link

Listed	Requires API KEY	Enabled by default	inline
Y	Y	Y	Y

Commands

/shorten <url>

/shorten https://github.com/SEEDTEAM

Lmgtfy

Let me google that for you !

Listed	Requires API KEY	Enabled by default	inline
Y	N	Y	Y

Location

Sends location data

Listed	Requires API KEY	Enabled by default	inline
Y	N	Y	N

Commands

/loc <query>

/location <query>

Me

Your profile in telegram !

Listed	Requires API KEY	Enabled by default	inline
Y	N	Y	Y

Commands

/me <parameter> <query>

/me facebook jackbot

/me <parameter> del

Will delete

/me

Will return your profile and msg Statistics

Can also be triggered by reply

Poll

Create a poll

Listed	Requires API KEY	Enabled by default	inline
Y	N	N	N

Commands

/poll new <question>

Create a new poll

/poll add <option>

Added a answer option

/poll del

Delete or terminate the Poll

/poll

Shows the poll

QRcode

Send a QRcore

Listed	Requires API KEY	Enabled by default	inline
Y	N	N	N

Commands

/qr <text>

Generates a QR code

Reactions

Reactions

Listed	Requires API KEY	Enabled by default	inline
Y	N	Y	Y

Commands

/reactions

Returns list of reactions

Remind

Reminder

Listed	Requires API KEY	Enabled by default	inline
Y	N	Y	N

Commands

/remind <delay (value|mh)> <text>

/remind 1h test

/remind 1m test

/remind 1h30m test

This plugin will save data in Redis(database) So It even works after Bot crashed or anything happen

set

Plugin for saving values

Listed	Requires API KEY	Enabled by default	inline
Y	N	Y	N

Commands

/set <value_name> <data>

Shell

Run terminal commands

Listed	Requires API KEY	Enabled by default	inline
N	N	N	N

Commands

/shell <Command>

/shell date

Slap

Slap someone

Listed	Requires API KEY	Enabled by default	inline
Y	N	Y	N

Commands

/slap

By reply

/slap <name>

Spotify

Spotify plugin

Listed	Requires API KEY	Enabled by default	inline
Y	O	Y	Y

Commands

/spotify get <track name(for search)>

Returns preview of that song (only 30 sec)

/spotify track <track name(for search)>

Returns track info and picture

/spotify album <album name(for search)>

Returns album info and picture

/spotify artist <artist name(for search)>

Returns artist info and picture

/spotify playlist <playlist name(for search)>

Returns playlist info and picture

Stats

Chat msg statistics

Listed	Requires API KEY	Enabled by default	inline
Y	N	Y	N

Commands

/chatstats

Returns a list of members with their msg statistics

Sticker

Return a sticker with your text

Listed	Requires API KEY	Enabled by default	inline
Y	N	Y	N

Commands

/sticker <text>

Talk

Returns voice

Listed	Requires API KEY	Enabled by default	inline
Y	N	Y	N

Commands

/tts <text>

TelegramCli

Control a real telegram account

Listed	Requires API KEY	Enabled by default	inline
N	N	N	N

Commands

/tg <Telegram-cli command

More info

Time

Returns the time, date, and timezone for the given location

Listed	Requires API KEY	Enabled by default	inline
Y	N	Y	Y

Commands

/time <location>

Translate

Yandex translate

Listed	Requires API KEY	Enabled by default	inline
Y	Y	Y	Y

/translate <language> <text>

Will translate text to language

/translate <language>

examples:

en for translating text to english

ar-en for translating text from arabic to english

You can use both

Can be used by replying to a msg

Urban dictionary

Returns the top definition from Urban Dictionary.

Listed	Requires API KEY	Enabled by default	inline
Y	N	Y	N

Commands

/ud <query>

weather

Returns the current weather

Listed	Requires API KEY	Enabled by default	inline
Y	N	Y	Y

Commands

/weather <city>

Webshot

Returns screen shot from given website

Listed	Requires API KEY	Enabled by default	inline
Y	Y	Y	N

Commands

/webshot <url>

Who

Returns info about user and chat

Listed	Requires API KEY	Enabled by default	inline
Y	N	Y	Y

Commands

/who

Wikipedia

Returns results from wikipedia.com

Listed	Requires API KEY	Enabled by default	inline
Y	N	Y	N

Commands

/wiki <query>

/wikipedia <query>

Youtube

Returns results from youtube.com

Listed	Requires API KEY	Enabled by default	inline
Y	Y	N	Y

Commands

/youtube get <video name(for search)>

/youtube dl <video name(for download)>

Support and development

Join our development group by sending /join 1047524697 to @TeleSeed

Special thanks to

Alphonse

Vamptacus

topkecleon

Yago

Collaborators

Unfriendly

Tiago Danin

Other projects

TeleSeed

An advance Administration bot

TelegramLoggingBot

Connects 2 groups or can be used to create a logging group

file-manager-bot

A Linux file manager telegram bot