Git Product home page Git Product logo

flibot's Introduction

Telegam bot for Flibusta Build Status

Русская версия здесь

Allows to search, browse and download books from Flibusta library. Uses TOR to connect to Flibusta hidden service. Uses Telegram Bot API. Respond only to the bot admin or telegram users which are allowed by the bot admin.

Installation

First of all ensure there is a tor instance installed and available for use. You also will need Java 8 to run the bot. There are several ways you may install this bot on your host:

From the source code

Make sure you have Git installed , then check out the bot source code to your host:

git clone https://github.com/flicus/flibot

next you need to build the bot from source codes:

cd flibot
gradlew shadowJar

now you ready to start the bot, fat jar with all dependencies included are here starter/build/libs/starter-0.9.0-all.jar

Download jar file

Download it from Release page

Configuration

Before you will start the bot you need to do some configuration. Bot checking for configuration parameters in the environment variables first. If there is flibot variable exist, all parameters will be read from the environment variables. Otherwise, bot searching for bot.ini file with these parameters.

Parameters

  • name - telegram bot name
  • token - telegram bot token
  • usetor - using tor or not
  • torhost - host where tor installed
  • torport - port of the tor
  • admin - telegram username who will be admin for this bot instance

bot.ini file example

name=test_bot
token=123456:blablabla
usetor=true
torhost=localhost
torport=9050
admin=myusername

Start up

java -jar starter-0.9.0-all.jar &

Supported commands

Just type your favorite author name or book title in the chat, bot will ask where should it search this - among authors or book titles, additional commands supported:

/k                  - OPDS catalog browsing
/r <username>       - add username to the allowed list (available only to the bot admin)
/u <username>       - remove username from the allowed list (available only to the bot admin)

flibot's People

Contributors

flicus avatar mars-1 avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.