// readme

v2ray-configs

Automatically fetches the latest 100 V2Ray/Xray configs from a Telegram channel every 30 minutes and writes them to configs.txt and configs.yaml โ€” ready to use as a subscription URL in any compatible client (v2rayNG, Nekoray, Hiddify, FLClash, Clash Party, etc.).

[!NOTE] This project was built with the assistance of Claude (Anthropic). The code, structure, and documentation were generated through an AI-assisted development session and reviewed by the author.


Setup

1 โ€” Fork / clone this repo

git clone https://github.com/amir-reza-bijandi/v2ray-configs
cd v2ray-configs
bun install

2 โ€” Get Telegram API credentials

  1. Go to my.telegram.org โ†’ API development tools
  2. Create an app โ†’ note your API ID and API Hash

3 โ€” Generate a session string (run once, locally)

bun run gen-session

Follow the prompts (phone number + verification code). It will print a session string โ€” copy it.

The session string lets the GitHub Action authenticate without interactive login.
Keep it secret โ€” it has full access to your Telegram account.

4 โ€” Add GitHub Secrets

Go to yourโ€ฆ