Looksyk

A simple personal knowledge platform with a focus on clean markdown files, simple queries and a journal.


Project maintained by SebastianRzk Hosted on GitHub Pages — Theme by mattgraham

Idea and technical concept

Table of Contents

This page

Further Reading

Technical concept

With Looksyk I want to create a local platform to collect information.

Currently, the backend renders all content in Markdown, which is displayed with Marked in the frontend. This makes Looksyk relatively close to the Markdown standard. Code highlighting is done with highlightjs and emojis with openmoji. The application is wrapped in an electron app (with electron forge).

Even if the project is currently a pure web project, I would not deploy it publicly because the project in its current state has not paid much attention to security (for example Injection-Attacks or Path-Traversal-Attacks).

Currently, the backend is very fast, my Logseq graph (~900 pages and 900kb text) is scanned and indexed in under a second (~80ms on a 3-year-old Laptop). That’s why Looksyk does not have a database, reading new data into RAM is fast enough.

The frontend still has some challenges. Performance and design can be improved and sometimes scrolling on the journal page has issues.

Tested browsers:

Browser Compatibility
application-wrapper (Electron) works
Chromium / Chrome works
Firefox works on nightly (Jan 2025), contenteditable=plaintext-only required

Tested operating systems

OS Compatibility
Linux works
Windows Not tested. The build script certainly doesn’t work (at least not without WSL). In addition, the resolution of the home directory may fail (please specify --graph-location) and the desktop shortcut doesn’t work. Otherwise, Looksyk should be programmed platform independent.
MacOs Not tested. Keyboard shortcuts are currently only designed for a Windows keyboard layout, but this can be changed via a pull request. There are also likely to be challenges in the build script. Otherwise, Looksyk is programmed to be platform-independent.

Project work and future

The project is a little hobby of mine, and I program a few lines sometimes when I feel like it and have the time.

I am happy about every contribution, but I cannot guarantee that I will implement every feature request.

If you have any changes or suggestions, please send me a pull request. For feature requests and bugs, you can submit an issue (or a pull request if you can).