repository·main·Indexed 43 days ago
https://github.com/evex-dev/linejsA JavaScript library for creating LINE SelfBots, supporting Node.js, Deno, and Bun. It includes specialized packages for the main Client, call control-plane and media, Thrift read/write functionality, and storage implementations. The library provides tools for interacting with LINE APIs, including a Thrift class for encoding/decoding data and a pipeline to sync Thrift schemas from LINE Android APKs.
LINEJS is organized into several specialized packages:
@evex/linejs: Contains the main Client for the LINE SelfBot.@evex/linejs/base: Provides BaseClient (the LINE SelfBot API Client).@evex/linejs/call: Helpers for call control-plane and media.@evex/linejs/thrift: Thrift read/write functionality.@evex/linejs/storage: Storage implementations including BaseStorage, MemoryStorage, and FileStorage.@evex/linejs-types: All TypeScript types and enums (e.g., ReactionType, MessageType) used by LINE.LINE calls are split into two distinct layers that must be managed sequentially:
setup_req to make the peer ring, wait for a conn_req when they answer, and finally send a conn_rsp to complete the handshake.If signaling succeeds but no audio is heard, the issue typically lies in the media plane configuration (e.g., key mode, payload prefix, Opus frame size, or RTP timestamping).
Control plane:
ask LINE for a route
connect to the PLANET relay
send setup_req so the peer starts ringing
wait for conn_req when the peer answers
send conn_rsp to finish negotiation
Media plane:
derive SRTP keys from the answer material
encode audio as Opus
wrap each Opus frame the way native PLANET audio expects
send RTP packets protected by SRTPThe device option in the BaseClient constructor affects which APIs are available. Some features are gated by the device type used in the protocol.
DESKTOPWIN: Sufficient for most bot automation and message sending.ANDROID / ANDROIDSECONDARY: Required for features like getContactsV3, getContactCalendarEvents, and VOOM/Timeline REST API access via client.voomRest().If you encounter an API method not capable error, you likely need to switch your device type.
When attempting to use LINEJS in a browser, you will encounter CORS (Cross-Origin Resource Sharing) errors when calling the LINE endpoint. You have two primary options to resolve this:
https://legy-jp.line-apps.com/sn.If you need to persist data to a remote location (e.g., a cloud API) instead of a local file, you can implement a custom storage provider by extending the BaseStorage class.
import { BaseStorage } from "@evex/linejs/storage";
// Implement your own storage logic by extending BaseStorage
class MyCloudStorage extends BaseStorage {
// ... implementation
}While BaseClient provides low-level Thrift RPC access, the Client wrapper (built on top of BaseClient) provides a richer, more developer-friendly API for common tasks. Use Client if you need to:
getMyProfile(), updateMyDisplayName(), updateMyStatusMessage(), updateMyProfile(), uploadMyProfileImage(), uploadMyProfileBackground()fetchJoinedChats(), getChat(), getUser(), rename(), setFavorite(), mute()getBgm(), setBgm()liff.shareMessages() and liff.getToken()An outgoing 1:1 audio call in LINEJS follows a seven-phase lifecycle involving route acquisition, transport connection, signaling via Cassini, and media transmission via SRTP.
client.call.acquireRoute to get routing metadata, PLANET endpoints, and bootstrap parameters (mpkey). Routes are short-lived.PlanetTransport.connect({ route }) to initialize the UDP socket and derive transport encryption keys via ECDH.setup_req: Use transport.inviteDetailed({ to }) to start ringing the peer. This sends a Cassini setup message inside an encrypted PLANET frame.setup_rsp) provides the relay's nonce, which is required for subsequent valid PLANET headers.conn_req: When the peer answers, the relay sends a connection request. Use transport.waitForAnswerDetailed to handle this.mediaReady is true, send audio using transport.send(). The payload must be the LINE audio payload (Opus with a specific prefix), not a raw RTP packet.transport.close() to tear down the session and close the UDP socket.// High-level conceptual flow
const route = await client.call.acquireRoute({ to, callType: "AUDIO" });
const transport = new PlanetTransport({ route });
await transport.connect({ route });
await transport.inviteDetailed({ to });
const answer = await transport.waitForAnswerDetailed({ autoConnRsp: true, timeoutMs: 60_000 });
if (answer.mediaReady) {
// Start sending media
}
await transport.close();The extractor uses three tiers of evidence to decide whether to automatically apply changes from an APK to the linejs types. This prevents incorrect mappings caused by R8/ProGuard obfuscation.
| Tier | Method | Reliability |
|---|---|---|
| A | Canonical name | Identity: LINE does not obfuscate com.linecorp.square.protocol.thrift.* |
| B | Wire RPC string | Strong: Keyed by R8 short name; only kept if field names overlap |
| C | Field-name overlap | Weak: Useful for large enums, but unreliable for small, generic structures |
| Change Kind | Auto-applied? | Condition |
|---|---|---|
| New enum value (Tier A) | Yes | Additive |
| New enum value (Tier B/C) | Conditional | Only if enum has $\ge$ --enum-add-min-members (default: 16) |
| New struct field (Tier A) | Yes | Additive |
| New struct field (Tier B) | Conditional | Only if overlap $> $ --min-overlap (0.6) AND shares $\ge$ --min-shared-fields (3) |
| New struct field (Tier C) | No | Reported for manual review |
| New type (enum/struct) | Yes | Canonical names only |
| Field change (Tier A) | Yes | High confidence |
| Field change (Tier B/C) | Conditional | Requires --min-overlap (0.6) and unique field-name sets |
| Obfuscated R8-synthetic names | No | Prevents noise |
Note: A full report of what was applied, held, or mismatched is generated at <decompiled-dir>/extract_report.json.
Most LINE chat messages are encrypted. You cannot read op.message.text directly from a polling event. You must use the e2ee service to decrypt the message chunks.
Required Pattern:
const msg = await client.e2ee.decryptE2EEMessage(op.message);
console.log(msg.text);LINEJS provides several core advantages for developers building LINE automation tools:
RateLimit are enabled to protect your account from automated detection or bans.LINEJS supports Node.js, Deno, and Bun runtimes, as well as TypeScript. You can install it using the following commands depending on your runtime:
Node.js (via JSR):
npx jsr add @evex/linejsBun (via JSR):
bunx --bun jsr add @evex/linejsDeno (via JSR):
deno add @evex/linejsnpx jsr add @evex/linejs