An open API service indexing awesome lists of open source software.

https://github.com/angus6b23/telegram-membership-card-bot

A telegram bot allows you to save and share membership cards and gift cards with your family or friends
https://github.com/angus6b23/telegram-membership-card-bot

barcode gift-card grammy membership-card qrcode sqlite telegram-bot

Last synced: 7 months ago
JSON representation

A telegram bot allows you to save and share membership cards and gift cards with your family or friends

Awesome Lists containing this project

README

          


tg-mb-card-bot-logo

# Telegram Membership Card Bot


GitHub License
Liberapay receiving

A telegram bot allows you to save and share membership cards and gift cards with your family or friends

## Screenshots

[screenshot1](https://raw.githubusercontent.com/angus6b23/telegram-membership-card-bot/master/assets/screenshots/screenshot-1.png)
[screenshot2](https://raw.githubusercontent.com/angus6b23/telegram-membership-card-bot/master/assets/screenshots/screenshot-2.png)
[screenshot3](https://raw.githubusercontent.com/angus6b23/telegram-membership-card-bot/master/assets/screenshots/screenshot-3.png)
[screenshot4](https://raw.githubusercontent.com/angus6b23/telegram-membership-card-bot/master/assets/screenshots/screenshot-4.png)
[screenshot5](https://raw.githubusercontent.com/angus6b23/telegram-membership-card-bot/master/assets/screenshots/screenshot-5.png)
[screenshot6](https://raw.githubusercontent.com/angus6b23/telegram-membership-card-bot/master/assets/screenshots/screenshot-6.png)

## Features

- Save and access your membership card and gift cards anywhere
- All codes are saved on your own instance
- Support common type of barcodes and qr codes
- Get code quickly by just typing the name of the code
- Role base access - Allow control which user is allowed to access membership cards and gift cards
- Keep track of the amount of remaining balance of your gift cards
- Large code generated easy for scanning at check-out machine

## Prerequisites

- A Telegram account for creating and interacting with the bot
- [Node.js](https://nodejs.org/) +/- [docker](https://www.docker.com/) installed on your machine

## Install / Deploying

1. Clone the git repository

`git clone https://codeberg.org/angus6b23/telegram-membership-card-bot.git`

2. Create your own telegram bot with [BotFather](https://telegram.me/BotFather) and save the token

- For details: See

3. Get the user id for your own telegram account with [Userinfo Bot](https://telegram.me/userinfobot)

4. Copy and Edit the environment variables required

`cp example.env .env`

then edit the .env file with your favorite editor (Set the bot token and user id you obtained on previous steps)

`nano .env`
`vim .env`

### With Node.js

5. Install dependencies using package manager

Using yarn
`yarn`

Using npm
`npm install`

6. Start the program

Using yarn
`yarn start`

Using npm
`npm run start`

### With docker (compose)

5. Build the application with package manager

Using yarn
`yarn build:docker`

Using npm
`npm run build:docker`

6. Start with the built image with docker compose

`docker compose up -d`

## License

![img](https://www.gnu.org/graphics/gplv3-or-later.png)

This app is provided under GPL v3.0 or later. For details, please visit