https://github.com/telent/eufon

Fennelish mobile phone thing. Mirror of https://gti.telent.net/dan/eufon
https://github.com/telent/eufon

Last synced: 13 days ago
JSON representation

Fennelish mobile phone thing. Mirror of https://gti.telent.net/dan/eufon

• Host: GitHub
• URL: https://github.com/telent/eufon
• Owner: telent
• License: lgpl-2.1
• Created: 2022-04-27T12:29:15.000Z (over 2 years ago)
• Default Branch: main
• Last Pushed: 2022-08-14T21:09:57.000Z (over 2 years ago)
• Last Synced: 2024-10-12T00:30:01.002Z (about 1 month ago)
• Language: C
• Homepage:
• Size: 490 KB
• Stars: 1
• Watchers: 3
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# 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](http://www.dest-unreach.org/socat/)

    $ eufonctl $WAYLAND_DISPLAY

## Building for a device

Eufon can be installed as a [Mobile NixOS](https://github.com/NixOS/mobile-nixos/) module, by adding

`module.nix` to the `imports` in `your configuration.nix`. For example, on my development phone I

have 

```nix

  imports = [

    (import  {

      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

- [X] notifications (crier)

- [X] web browser (just)

- [ ] keyboard

- [ ] wifi network chooser

- [ ] settings: toggle network interfaces, change volume & screen brightness

## Other

- [ ] better window management

	- gestures to switch view

	- gesture to launch terminal?

	- some way to kill an app

	- finish adding touch support to Kiwmi - https://github.com/buffet/kiwmi/pull/64

- [ ] some way to add launcher shortcuts for Fennel functions

- [ ] hook up system to session bus, to handle incoming calls

- [X] kiwmi: support reloading config or otherwise making live changes

- [ ] why are overlay windows overlapping regular view?

- [ ] screen lock