shtwzrd / friar

Emacs REPL for interacting with AwesomeWM

friar

Fennel Repl In Awesome Repl

What?

Interact with your running AwesomeWM session from inside Emacs, using Fennel, a lua-based Lisp.

Interested in using Fennel for writing your own AwesomeWM configuration? Check the starter-kit included in this repo. It contains an rc.lua that bootstraps loading the provided config.fnl file, which is a line-for-line translation of the default AwesomeWM configuration.

Installation

Via use-package with straight.el:

(use-package friar 
  :straight (:host github :repo "warreq/friar" :branch "master"
	     :files (:defaults "*.lua" "*.fnl")))

Usage

M-x friar and he's ready to serve you.

Troubleshooting

I can't connect to AwesomeWM (D-Bus error)

Try slapping this into your .xinitrc to ensure you have a DBUS_SESSION_BUS_ADDRESS, which Emacs needs in order to connect to your D-Bus.

if test -z "$DBUS_SESSION_BUS_ADDRESS" ; then
  eval `dbus-launch --sh-syntax --exit-with-session`
fi

Make sure dbus-launch exists on your path -- you may need to install a package like dbus-x11.

friar's Issues

Evaling from an .fnl file buffer

Thank you for this package, it makes my life a bit less difficult. Even though I understand that this is an old project and you may not use it much anymore, if I may, I have two questions:

First, is it possible to eval things directly from a .fnl buffer? I'd love to select an expression and let awesomewm execute it.

Secondly, why doesn't it understand local vars? Why, when I type something like (local gears (require :gears)) in the REPL buffer, doesn't it recognize that? I always have to make globals, i.e., (global gears (require :gears)). Perhaps I'm missing something? Maybe you wrote this project at the time when there was no built-in repl in fennel? What would be the most sensible REPL setup today, making them all to work together - Fennel, Emacs and AwesomeWM?