https://github.com/shtwzrd/friar
Emacs REPL for interacting with AwesomeWM
https://github.com/shtwzrd/friar
awesomewm emacs emacs-mode emacs-packages fennel repl
Last synced: 2 months ago
JSON representation
Emacs REPL for interacting with AwesomeWM
- Host: GitHub
- URL: https://github.com/shtwzrd/friar
- Owner: shtwzrd
- Created: 2019-05-05T21:52:56.000Z (about 6 years ago)
- Default Branch: master
- Last Pushed: 2020-05-05T01:19:17.000Z (about 5 years ago)
- Last Synced: 2024-07-29T17:04:06.138Z (10 months ago)
- Topics: awesomewm, emacs, emacs-mode, emacs-packages, fennel, repl
- Language: Emacs Lisp
- Homepage:
- Size: 12.7 KB
- Stars: 24
- Watchers: 2
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
- awesome-awesomewm-modules-widgets-and-libraries - friar
- awesome-awesomewm-modules-widgets-and-libraries - friar
README
# friar
_Fennel Repl In Awesome Repl_
## What?
Interact with your running AwesomeWM session from inside Emacs,
using [Fennel](https://fennel-lang.org), 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`.