🕵🏼‍♂️ Telegram Stories Viewer Bot

The bot allows to view Telegram stories anonymously by leveraging a bot and userbot

📸 Screenshots

⚙️ How it works?

Initiate the userbot:

```typescript import { TelegramClient } from 'telegram'; import { StoreSession } from 'telegram/sessions'; async function main() { const client = await initClient(); } async function initClient() { const storeSession = new StoreSession('userbot-session'); const client = new TelegramClient( storeSession, USERBOT_API_ID, USERBOT_API_HASH, { connectionRetries: 5, } ); await client.start({ phoneNumber: USERBOT_PHONE_NUMBER, password: async () => await input.text('Please enter your password: '), phoneCode: async () => await input.text('Please enter the code you received: '), onError: (err) => console.log('error: ', err), }); console.log('You should now be connected.'); console.log(client.session.save()); // Save the session to avoid logging in again await client.sendMessage('me', { message: 'Hi!' }); return client; } ```

• Get user's entities by username:

const username = '@chupapee';
const entity = await client.getEntity(username);

• Get stories data by entity:

import { Api } from 'telegram';

const activeStories = await client.invoke(
  new Api.stories.GetPeerStories({ peer: entity })
);

const pinnedStories = await client.invoke(
  new Api.stories.GetPinnedStories({ peer: entity })
);

• Download stories using media prop of story object:

const stories = await downloadStories(activeStories, pinnedStories);

async function downloadStories(activeStories, pinnedStories) {
  const result = [];

  for (const story of [...activeStories, ...pinnedStories]) {
    const buffer = await client.downloadMedia(story.media);
    if (buffer) {
      result.push({
        buffer,
        mediaType: 'photo' in story.media ? 'photo' : 'video',
      });
    }
  }

  return result;
}

• Send downloaded stories to user using Telegraf api (not Gramjs's userbot):

import { Telegraf } from 'telegraf';

const bot = new Telegraf(BOT_TOKEN);
bot.telegram.sendMediaGroup(
  chatId,
  stories.map((story) => ({
    media: { source: story.buffer },
    type: story.mediaType,
  }))
)

🧰 Tools Used

🤖 GramJS 🤖 - Provides access to the Telegram client API based on MTProto

👾 Telegraf 👾 - Provides access to the Telegram bot API

☄️ Effector ☄️ - used for writing the business logic of the app, ensuring efficient state management and handling of complex workflows

📦 Supabase 📦 - integrated for analytics data collection

🛠 Setup

To run this project locally, follow these steps:

Install all dependencies
```
yarn
```
Configure Credentials:

Set up your Telegram and userbot credentials in the configuration file

Start the bot:

Launch the bot in development mode using:

yarn dev

Enter Userbot Login Code:

Upon starting the bot, you'll receive a login code from Telegram. Enter this code when prompted by the userbot

Ready to Go:

Once the bot and userbot are up and running, the Telegram Story Viewer is ready to use!

🚀 Usage

Just send a message to the bot with the desired Telegram username, phone number, or the direct link to story. Wait for the bot to retrieve and deliver the stories back to you

chupapee / telegram-stories-viewer-bot

readme