Go to file
Daniel Barlow c485e59c3a explain how to start eufon on ssh connection 2022-08-14 14:45:41 +00:00
bin make an installable derivation 2022-08-14 10:48:18 +00:00
blinkenlicht merge blinkenlicht, add modeline 2022-04-26 22:13:37 +01:00
crier fudging to make it work as buildable derivation 2022-08-14 15:05:05 +01:00
just fudging to make it work as buildable derivation 2022-08-14 15:05:05 +01:00
kiwmi initial support for touch events 2022-07-12 23:16:44 +00:00
saturn fudging to make it work as buildable derivation 2022-08-14 15:05:05 +01:00
.gitignore make an installable derivation 2022-08-14 10:48:18 +00:00
LICENSE Create LICENSE 2022-04-27 13:33:17 +01:00
README.md explain how to start eufon on ssh connection 2022-08-14 14:45:41 +00:00
build.nix add kiwmi as git subtree and derivation to build it 2022-04-26 15:52:14 +01:00
carousel.png add some very professional icons 2022-05-08 22:38:44 +01:00
close-window.png add some very professional icons 2022-05-08 22:38:44 +01:00
default.nix Merge branch 'main' of gti.telent.net:dan/eufon 2022-08-14 14:07:49 +00:00
eufon.fnl fudging to make it work as buildable derivation 2022-08-14 15:05:05 +01:00
fennelrun.lua fudging to make it work as buildable derivation 2022-08-14 15:05:05 +01:00
init.lua fudging to make it work as buildable derivation 2022-08-14 15:05:05 +01:00
kiwmi.nix kiwmi debug build 2022-05-18 10:33:37 +01:00
launcher.png add some very professional icons 2022-05-08 22:38:44 +01:00
lua-dbus-proxy.nix add dependencies for saturn 2022-04-26 23:01:30 +01:00
matrix.fnl add some matrix functions 2022-07-03 23:08:33 +01:00
modeline.css merge blinkenlicht, add modeline 2022-04-26 22:13:37 +01:00
modeline.fnl fudging to make it work as buildable derivation 2022-08-14 15:05:05 +01:00
module.nix stuff 2022-08-14 14:07:29 +00:00
pinephone.nix some generally (I hope) useful config for the Pinephone 2022-07-03 23:08:33 +01:00
refresh-bootfs.nix some generally (I hope) useful config for the Pinephone 2022-07-03 23:08:33 +01:00
run.sh kiwmi verbose log and sensible syslog identifier 2022-07-12 23:16:45 +00:00
shell.nix explain how to start eufon on ssh connection 2022-08-14 14:45:41 +00:00
socket-repl.fnl extract function 2022-07-03 11:09:02 +01:00
texture.fnl extract texture-from-file into module 2022-07-03 23:08:33 +01:00

README.md

eufon

Broken, not ready for use

euphony: noun Harmonious arrangement of sounds in composition; a smooth and agreeable combination of articulate elements in any piece of writing.

A mostly Fennel-based graphical environment tailored for Linux-based mobile devices. The principles we aspire to are

  • "habitable software" - build the system in such a way that a technically competent user may change it to serve their needs, potentially even in ways that weren't anticipated in the original design. Emacs has this quality.

  • optimised for touchscreens. My phone has no hardware keyboard and few hardware buttons, let's play to its strengths instead of compensating for its weaknesses

As of 2022 these principles are more aspirational than actual. This repo is basically in an advanced state of brokenness

Running the shell/apps locally

$ nix-shell
nix-shell$ kiwmi -c init.lua 

This works on desktop or on mobile - Kiwmi is built on wlroots, which will open a window on your existing Wayland or X11 desktop if you're running one.

If you're connected over ssh and want to run Kiwmi on the console, further contortions are required as you don't have the permissions by default: run this before attempting to start Kiwmi

 nix-shell -p seatd --run "sudo -b seatd -u $USER"

Connecting to the repl

By default Eufon opens a Unix socket to which you can connect to interact with a Fennel REPL. The eufonctl script is a wrapper around socat

$ eufonctl $WAYLAND_DISPLAY

Building for a device

Eufon can be installed as a Mobile NixOS module, by adding module.nix to the imports in your configuration.nix. For example, on my development phone I have

  imports = [
    (import <mobile-nixos/lib/configuration.nix> {
      device = "motorola-potter";
    })
    /home/dan/src/phoen/eufon/module.nix
  ];

Instructions for using Mobile NixOS are currently outside the scope of this README.

TODO

Packages

  • notifications (crier)
  • web browser (just)
  • keyboard
  • wifi network chooser
  • settings: toggle network interfaces, change volume & screen brightness

Other

  • better window management

  • some way to add launcher shortcuts for Fennel functions

  • hook up system to session bus, to handle incoming calls

  • kiwmi: support reloading config or otherwise making live changes

  • why are overlay windows overlapping regular view?

  • screen lock