arslaan@thinkpad-e16-void:~/projects

Projects

		

$ cat saffron.md | glow
		

			

				Saffron
			

			
A lightweight, extensible, and dead-simple retained-mode UI framework written in C and SDL3.


    

  • Built with: C, SDL3
    • 

  • Status: In development (alpha)
    • 





Features


    

  • Retained-mode widget system
    • 

  • GL support
    • 

  • Extensible and modular
    • 

  • Consistent styling across platforms
    • 





Why I built it


I looked at the current state of UI frameworks.


    

  • GTK: Not very good on platforms other than Linux, and kind of bloated.
    • 

  • Qt: Licensing headache, and styling is not consistent across platforms.
    • 

  • Dear ImGui: Not retained-mode.
    • 

  • Flutter: The toolchain is horrible, Dart sucks, and it's bloated.
    • 



And so, as I do, I decided to make my own lightweight and extensible UI framework on top of SDL3.




Notes


There are currently a few things TODO in Saffron, as it is currently in alpha. For this reason, I would not recommend using it in production at the moment.


    

  1. Write documentation
    2. 

  2. Test for other platforms (just because it theoretically should work, doesn't mean it will)
    3. 

  3. Add more built-in widgets
    4. 

  4. Possibly split it into 2 modular parts, SFCore and SFWidgetsBase (?)
    5. 



		
		

$ cat sfwk.md | glow
		

			

				SaffronWebKit
			

			
WPEWebKit bindings for Saffron, allowing you to embed webview widgets into any Saffron app with just a few lines of C.


    

  • Built with: C, SDL3, WPEWebKit, GStreamer, EGL
    • 

  • Status: Completed - in active development
    • 





Features


    

  • Full WebKit browser engine embedded into Saffron
    • 

  • Supports Wayland, X11, and even runs in a TTY via SDL3's kmsdrm driver
    • 

  • Full audio playback via GStreamer
    • 

  • WebGL, HTML5 multimedia, and many other web APIs via WebKit
    • 





Why I built it


When I was building Saffron, I thought it'd be really cool to rewrite cinnamon-browser with it once it was stable. The issue was, it's a custom UI framework, how does one put a browser in it? The answer: just write your own bindings! It can't be that hard... right? Right???? Right...


This took up way too much time and effort than I thought it would.




Notes


While Saffron itself is cross-platform, I cannot guarantee that SFWK will work across platforms because WPEWebKit, the library it is based on, is very much Linux-only.
I am also yet to write documentation, but I am currently delaying that until Saffron itself has a stable API, because SFWK is subject to change based on what happens in Saffron's codebase.


		
		

$ cat cinnamon.md | glow
		

			

				cinnamon-browser
			

			
A lightweight suckless-inspired vimlike browser written in C, powered by WebKit2GTK-4.1 and GTK3.


    

  • Built with: C, GTK3, WebKit2GTK
    • 

  • Status: Completed
    • 





Features


    

  • Vim-like keybindings
    • 

  • Command mode with :
    • 

  • Quickmarks (similar to ones in qutebrowser)
    • 

  • Tabs
    • 

  • Hint mode
    • 

  • Suckless-style C configuration file (config.h)
    • 





Why I built it


For a while, I was a long-time user of qutebrowser, a popular vim-like browser written in Python and PyQtWebEngine. It was a great browser, and worked very well for my use cases, but eventually, I ran into an issue: the browser was too heavy on my system. Even though back then I used a MacBook Pro M2, which is a powerful machine, I only had 8GB RAM, which, in this digital world, is absolutely nothing. Open too many Chrome tabs? Good luck, mr. OOM killer has come to your doorstep. Because qutebrowser is powered by PyQtWebEngine, which in turn is powered by Chromium, it tends to be quite heavy on my system and eat a lot of RAM.


So, to fix this problem, there was only one proper way. MAKE YOUR OWN BROWSER IN C AND WEBKITGTK!!!!!!!!!!!!!!!!!!!!!!!!!




Notes


This project will eventually be deprecated as I plan to rewrite it in Saffron, my UI framework. Why, you might ask? Because who doesn't want to have a custom browser written in their own custom UI framework AND their own custom browser engine bindings for that UI framework?! How, you might ask? With SFWK, of course! Did you not read the project listings above?


		
		

$ cat frenchtoastos.md | glow
		

			

				FrenchToastOS
			

			
A simple from-scratch OS for x86 systems written in C.


    

  • Built with: C, x86 Assembly, Makefile
    • 

  • Status: In-progress
    • 





Features


    

  • Framebuffer support (via GRUB)
    • 

  • Can render text via 8x8 font
    • 

  • Takes PS/2 keyboard input
    • 





Why I built it


This was originally for Boot, a Hack Club YSWS (You Ship, We Ship), but I may or may not have gotten distracted with other projects...

I might continue working on FrenchToastOS, but I have no guarantees.


		
		

$ cat zwzn-freefit-re.md | glow
		

			

				zwzn-freefit-re
			

			
Reverse-engineering of sketchy Chinese watches


    

  • Built with: jadx, reading Java source code, Markdown, Python, bleak
    • 

  • Status: Completed (inactive)
    • 





Features


    

  • Documents the protocol used by an app to communicate with a BLE smartwatch in-depth
    • 





Why I built it


There is a better and longer explanation in the Git repo's README itself, but to keep it short:


    

  • I had a sketchy watch from the arcade
    • 

  • The original app was spyware
    • 

  • I still wanted to use the watch
    • 

  • I reverse-engineered it
    • 

  • And then I may have broke it...
    • 





Notes


I also wrote a small Android companion app for these watches, as a replacement to the original. I can no longer add more features or test anything in relations to reverse-engineering or the companion app, because I may or may not have broke the watch...

You can find the companion app here.