Linkwarden Telegram Bot

A Telegram bot that integrates with Linkwarden to save and manage bookmarks directly from Telegram.

Features

• Save links to your Linkwarden collection
• Search your bookmarks
• Manage collections
• Automated link metadata extraction

Installation

Using Docker

1. Clone the repository

git clone https://github.com/yourusername/linkwarden-telegram-bot.git
cd linkwarden-telegram-bot

2. Build the Docker image

docker build -t linkwarden-telegram-bot .

3. Copy a .env.example to .env file

cp .env.example .env

4. Edit the .env file and set the required environment variables

TELEGRAM_TOKEN=your_bot_token
LINKWARDEN_API_URL=https://your-linkwarden-instance.com/api
LINKWARDEN_API_KEY=your_api_key
LINKWARDEN_COLLECTION_ID=your_collection_id

5. Run the Docker compose file

docker-compose up -d

Manual Installation

pip install -r requirements.txt

Set up environment variables

export TELEGRAM_TOKEN=your_bot_token 
export LINKWARDEN_API_URL=https://your-linkwarden-instance.com/api 
export LINKWARDEN_API_KEY=your_api_key 
export LINKWARDEN_COLLECTION_ID=your_collection_id

Run the bot

python bot.py