https://github.com/aqerd/filmbot

Bot that helps you find films you want to watch based on some filters like genre, year, actors, etc
https://github.com/aqerd/filmbot

feign java telegram telegram-bot tg tmdb tmdb-api urfu

Last synced: 6 months ago
JSON representation

Bot that helps you find films you want to watch based on some filters like genre, year, actors, etc

• Host: GitHub
• URL: https://github.com/aqerd/filmbot
• Owner: aqerd
• Created: 2024-09-26T07:04:36.000Z (about 1 year ago)
• Default Branch: main
• Last Pushed: 2025-01-16T17:45:51.000Z (9 months ago)
• Last Synced: 2025-03-30T01:51:50.180Z (7 months ago)
• Topics: feign, java, telegram, telegram-bot, tg, tmdb, tmdb-api, urfu
• Language: Java
• Homepage:
• Size: 283 KB
• Stars: 2
• Watchers: 1
• Forks: 0
• Open Issues: 2
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

          
# Filmbot

[![Follow @aqerd on GitHub](https://img.shields.io/github/followers/aqerd?label=Ruslan%20Suleymanov&style=social-&labelColor=black&color=111111)](https://github.com/aqerd)

[![Follow @AnnaKhairillina on GitHub](https://img.shields.io/github/followers/AnnaKhairillina?label=Anna%20Khairullina&style=social-&labelColor=black&color=111111)](https://github.com/AnnaKhairillina)

[![Watch filmbot on GitHub](https://img.shields.io/github/watchers/aqerd/filmbot?label=Watch&style=social-&labelColor=black&color=111111)](https://github.com/aqerd/filmbot/subscription)

[![Star filmbot on GitHub](https://img.shields.io/github/stars/aqerd/filmbot?label=Star&style=social-&labelColor=black&color=111111)](https://github.com/aqerd/filmbot)

[![Open issues for filmbot](https://img.shields.io/github/issues/aqerd/filmbot?label=Issues&labelColor=black&color=111111)](https://github.com/aqerd/filmbot/issues)

#### This bot helps you find films you want to watch based on some filters like genre, year and more

## 🚀 Usage

You can use bot [here](https://t.me/oopfilmbot) in Telegram

## 🔗 How to start the project on your own

To start this you can clone our repository:

```bash

git clone git@github.com:aqerd/filmbot.git

```

Next, create a file `assets/token.env` and add your API keys like this:

```env

TELEGRAM_BOT_TOKEN=0123456789:rs96Th1SaPiK3YiSdEfin1t3lyFaK310ak8

TMDB_ACCESS_TOKEN=2ak4fake34api4433key4lol7035rs39

```

You can get your TMDb API key [here](https://www.themoviedb.org/settings/api) and create your Telegram bot [here](https://t.me/BotFather).

Now you ready to run this project on your machine.

Please note that you cannot access the TMDb API from Russia and Kazakhstan. To resolve this issue, manually change your network connection's DNS to `9.9.9.9`.

## 💽 Build with or without database

You can use this bot without database feature. Use [no-db-branch](https://github.com/aqerd/filmbot/tree/no-db-branch)

## 🔨 Tools

- Java with Maven

- Telegram API with [telegrambots](https://github.com/rubenlagus/TelegramBots)

- The Movie Database API

- [Feign](https://github.com/OpenFeign/feign) with [Gson](https://github.com/google/gson)

## 🧑‍💻 Credits

Project made by **Ruslan Suleymanov** and **Anna Khairullina** for Object-Oriented Programming course at Ural Federal University