okline 2.4.0

OkLine — an unofficial, high-level Python client / SDK for the LINE Chrome messaging API (CHROMEOS 3.7.2): send messages, QR & email login, X-Hmac signing, and full response recording.

OkLine

A high-level Python client / SDK for the LINE Chrome messaging API.

OkLine reproduces the API of the official LINE Chrome extension (CHROMEOS 3.7.2) — send and receive messages, log in by QR or e‑mail, and automate your own account from Python. The protocol is reproduced faithfully, including the mandatory X-Hmac signature (computed by LINE's real ltsm.wasm), so requests are byte‑for‑byte what the real client sends.

from okline import OkLine

api = OkLine(access_token="…", refresh_token="…")
print(api.get_profile())
api.send_text("u0123456789abcdef0123456789abcdef", "hello from python")

Features

• All 77 endpoints — typed methods, or call any of them generically.
• QR & e‑mail login — QR rendered as ASCII right in your terminal.
• X-Hmac signing — handled automatically via the bundled WASM module.
• Bot framework — @bot.on_message, typed models, session persistence.
• Response recording — capture, redact and export every request/response.
• CLI — python -m okline … to call any endpoint from the shell.

Install

Prerequisites

• Python 3.9+
• Node.js 18+ on your PATH — required to compute the mandatory X-Hmac request signature (the real ltsm.wasm runs through a tiny Node bridge; details). Check with node --version.

Install from source (recommended — installs OkLine and its dependencies):

git clone https://github.com/NiceDayZc/okline.git
cd okline
pip install -e .          # installs the `okline` package + requests + cryptography
pip install qrcode        # optional: render the QR-login code in your terminal

Verify it works:

python -m okline version

Not on PyPI yet. Once published you'll be able to pip install okline — until then use the source install above.

First login (do this once; the session is then reusable):

python -m okline qr-login --save tokens.json     # scan the QR with the LINE app
python -m okline profile --tokens-file tokens.json

Quick start

from okline import OkLine, Bot

# log in once, reuse the session forever
api = OkLine()
api.auth.qr_login(on_qr=print)        # scan the QR with your phone
api.save_tokens("session.json")

# next time
api = OkLine.from_tokens_file("session.json")
api.send_text("c…group…mid", "hi from python")

# a 3-line echo bot
bot = Bot(api)
bot.on_message(lambda ctx: ctx.reply(f"you said: {ctx.text}"))
bot.run()

From the shell:

python -m okline qr-login --save tokens.json
python -m okline call Talk.TalkService.getProfile "[2]" --tokens-file tokens.json
python -m okline send <mid> "hello" --tokens-file tokens.json

Documentation

Guide
Getting started	install, first call, the OkLine object
Authentication	token reuse, e‑mail (RSA), QR login, refresh
Sending messages	text, stickers, location, media, reactions
Receiving events	the SSE stream and a simple bot
Building bots & helpers	bot framework, typed models, sessions
Recording	paste / export every response
CLI	every python -m okline command
Architecture	the protocol, X-Hmac, module map
Endpoint reference	all 77 endpoints with their fields
Troubleshooting · Contributing

Disclaimer

OkLine is unofficial and not affiliated with LINE Corporation. Use it only with your own account and in compliance with LINE's Terms of Service. Treat tokens like passwords — see SECURITY.md.

License

MIT