diff options
Diffstat (limited to '')
-rw-r--r-- | posts/weltschmerz.md | 77 |
1 files changed, 77 insertions, 0 deletions
diff --git a/posts/weltschmerz.md b/posts/weltschmerz.md new file mode 100644 index 0000000..bdaeced --- /dev/null +++ b/posts/weltschmerz.md @@ -0,0 +1,77 @@ +title: weltschmerz - A terminal emulator in Vala +date: 2019-07-12 +author: Wolfgang Müller + +## Synopsis + +weltschmerz is a small and simple terminal emulator built upon the +Virtual Terminal Emulator widget. It's written in Vala, supports +clickable URLs, can reload its configuration whilst running, and has +very basic search functionality. + +![weltschmerz in action](img/weltschmerz.png) + +As a VTE app, weltschmerz supports practically every contemporary +terminal emulator feature. It is built to be a stable and practical +terminal emulator for daily use. + +## Download + +- [weltschmerz-1.0.0.tar.gz](/snapshots/weltschmerz/weltschmerz-1.0.0.tar.gz) + ([signature](/snapshots/weltschmerz/weltschmerz-1.0.0.tar.gz.SHA256.sig), + [checksum](/snapshots/weltschmerz/weltschmerz-1.0.0.tar.gz.SHA256), + [verify?](verify.html), + [archive](/snapshots/weltschmerz)) +- [git repository](https://git.oriole.systems/weltschmerz.git) (clone only, no web interface) + +## Requirements + +- [VTE](https://wiki.gnome.org/Apps/Terminal/VTE) >= 2.91 +- [Vala](https://wiki.gnome.org/Projects/Vala) >= 0.40.12 +- [GTK+](https://www.gtk.org/) >= 3.0 + +## Usage & Configuration + +See [`weltschmerz(1)`](/man/weltschmerz.1.html). + +## Build + +weltschmerz can be built with any POSIX-conformant make or with +[Meson](https://mesonbuild.com). The latter may be interesting to +distribution packagers or people already comfortable with this +particular build system. + +__Note:__ if your Vala compiler executable is not named `valac`, you +need to export the environment variable `VALAC` containing the correct +name before you can build weltschmerz: + + export VALAC='valac-0.42' + +### Makefile + +Run the following to build and install weltschmerz to the default +location (`/usr/local`): + + make install + +The Makefile honors the environment variables `PREFIX`, `DESTDIR`, +`BINDIR`, and `MANDIR`. For instance, if you want to install weltschmerz +to your home directory, call make like so: + + PREFIX=/home/user make install + +### Meson + +Create the build directory and configure the Meson build like so: + + meson build + cd build + meson configure + +The build can be configured extensively; for more information, see +`meson(1)`. If you want to install weltschmerz to your home directory, +for example, pass `--prefix=/home/user` to configure. + +Once the build is set up, install weltschmerz: + + meson install |