ackandClaude Fable 5.1
89b4a41b2a
With the Text tool, Klammertext's codes give letters a keyboard lacks: ^o" is ö, ^s^ ß, ^a1 ā, ^130ED^ a code point of 4 to 6 digits, ^9053 53EF^ a sequence, ^^ a caret, replaced as each code is completed. The public site and relay moved to app.kokkoja.com; the old name redirects. The Markdown documentation is withdrawn from the release while it is converted to Klammertext; the README's links to it are stale until then. Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Kokkoja
Kokkoja lets people at different computers write together on a shared page, by hand or by typing, with every page saved automatically to each person's own notebook. It runs in a web browser beside a video call and replaces the call's screen sharing and annotation. It was made first for teaching a foreign language over a video call, and it serves any work that two or more people would otherwise do over one sheet of paper.
Kokkoja is free software under the GNU General Public License, version 3 or later: see LICENSE.md, which also says how the name may be used.
Documentation
- An introduction: what Kokkoja does and whom it is for.
- Kokkoja in five minutes: the shortest path to a shared page, for someone at home in a terminal.
- A guest's Kokkoja: joining a session from an invitation, and the screen.
- A host's Kokkoja: installing the Kokkoja program, starting a session, inviting guests, driving the session.
- How Kokkoja works: the parts, the encryption, the page file, running a server.
In short
A guest needs nothing but a web browser: open the invitation link, enter
a name, join. A host can start a session from the same web site,
https://app.kokkoja.com/, with the notebooks kept in the
browser.
A host who wants notebooks as files needs Python 3 and this directory:
python3 kokkoja.py --relay wss://app.kokkoja.com/relay
opens Kokkoja in the browser; Start a session gives an invitation to
send to the guests. Notebooks are directories in Kokkoja in the
Documents directory.
What is here
kokkoja.py: the local program, which serves the client to your browser and keeps your notebooks as files. Python standard library only.client/: the client, plain JavaScript modules run by the browser as written.relay/: the relay server, Python with thewebsocketslibrary.deploy/: how a Kokkoja server is set up (relay plus web site).docs/: the documentation above.tests/: the tests (python3 -m unittest discover tests); the end-to-end test needs Firefox and geckodriver, and the QR code's test needs Node.js andpip install -r tests/requirements.txt.LICENSE.md: the license.