Selfbot LINE New

A TTCORE API-powered LINE selfbot platform with multi-user Helper management and advanced Flex interfaces.

Overview · API Docs (EN) · API Docs (TR) · API Docs (中文)

Important

This repository contains no email addresses, passwords, LINE tokens, refresh tokens, certificates, MID lists, or live sessions. These values are created only at runtime and are excluded from Git through .gitignore.

Interface

  

• Two Flex themes: Default and Transformers
• Multi-page help menu and a separate help2 menu for newer commands
• APNG lighting/fan effects, profile pictures, and reader-radar cards
• Flex cards for profiles, groups, API status, latency, runtime, and command results

Components

Component	Purpose
TTStaf.py	Main selfbot, group automation, and Flex responses
helper.py	Membership/admin management, QR login, and user instance management
lineapi/	LINE protocol, Sync, E2EE, media, reactions, rooms, and call services
ttcore_api.py	Adapts TTCORE API sessions to the legacy selfbot method surface
deploy/	systemd units for Helper and per-user TTStaf services

flowchart LR
    U["LINE user"] --> H["Helper"]
    H -->|"QR + PIN"| A["TTCORE LINE API"]
    A --> L["LINE services"]
    H --> I["Isolated TTStaf user instance"]
    I --> A
    I --> F["Flex menus and automation"]

Loading

Highlights

Helper

• adduser @user 30: grants time-limited access to a user
• userlist: displays members as a numbered, mention-aware list
• deluser 1: removes the selected member from the access list
• addadmin @user: grants Helper administrator access
• login: starts QR and PIN authentication in the conversation where the command was sent
• Creates an isolated API session, settings directory, and TTStaf service for every user
• Stops expired memberships and restores valid sessions after service restarts
• Prevents duplicate Sync pollers from using the same LINE account

TTStaf and command bot

• Flex-based help, help2, profile, group, and API menus
• ping, speed, runtime, me, mid, and mentionmid
• Mention-based kick, ban, bankaldır, koru, and invitation commands
• grupinfo, group name/image/QR management, and group lists
• ra, rk, and getreader: advanced reader radar with profile images
• Member mentions, broadcasts, welcome messages, and automatic join options
• Add/remove message reactions and silently unsend messages
• Legacy room creation, room invitations, and room details
• Call links, numbered selection/deletion, and active call information
• Runtime switching between Default and Transformers Flex themes

See the detailed command guide for the current command list.

Installation

1. Clone the repository

git clone https://github.com/turanbots/Selfbot-Line-New.git /root/yeni
cd /root/yeni

2. Create the Python environment

python3 -m venv .venv
.venv/bin/python -m pip install --upgrade pip
.venv/bin/python -m pip install -r requirements.txt

Windows activation:

python -m venv .venv
.\.venv\Scripts\Activate.ps1
python -m pip install -r requirements.txt

3. Run the main TTStaf selfbot

python3 TTStaf.py

On first launch, TTStaf creates empty runtime configuration files automatically. TTCORE API starts a QR session, and the local API session is stored under .ttcore/ after login succeeds.

4. Run Helper

python3 helper.py

On first launch, Helper requests the LINE email and password interactively. Environment variables listed in .env.example may also be used. Never place credentials directly in source files.

systemd installation:

sudo cp deploy/ttcore-helper.service /etc/systemd/system/
sudo cp deploy/ttcore-ttstaf@.service /etc/systemd/system/
sudo systemctl daemon-reload
sudo systemctl enable --now ttcore-helper.service

Environment variables

Variable	Description
TTCORE_API_URL	API base URL; defaults to https://ttcoreweb.com/line-api/v1
TTCORE_API_SESSION_FILE	Path to the local, user-specific API session file
TTCORE_OPEN_QR	Set to 1 to open QR images automatically, or 0 to disable it
TTCORE_LINE_EMAIL	Helper LINE login email; never commit this value
TTCORE_LINE_PASSWORD	Helper LINE password; never commit this value

Security

• .ttcore/, instances/, tokens, certificates, and runtime JSON files are ignored by Git.
• Do not commit email addresses or passwords; prefer interactive login when possible.
• If a secret is committed accidentally, deleting the file in a later commit is not sufficient. Revoke the secret immediately and remove it from Git history.
• See SECURITY.md for the repository's security policy.

Disclaimer

This project is not an official LINE SDK and is not affiliated with LINE. You are responsible for your account and automation activity. Follow LINE's terms, group permissions, and all applicable local laws.