aboutsummaryrefslogtreecommitdiff
path: root/README.md
blob: d92dff042cdd4da97c0b42b7ea6a94451df429d2 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
## Shells Bells

### A just-for-fun LV2 plugin bundle

The most limited, useless, hackable and fun plugin bundle ever. Sound the bell in the shell
(or from any program forked from the latter) to send a MIDI note.

#### Build status

[![build status](https://gitlab.com/OpenMusicKontrollers/shells_bells.lv2/badges/master/build.svg)](https://gitlab.com/OpenMusicKontrollers/shells_bells.lv2/commits/master)

### Binaries

For GNU/Linux (64-bit, 32-bit).

To install the plugin bundle on your system, simply copy the __shells_bells.lv2__
folder out of the platform folder of the downloaded package into your
[LV2 path](http://lv2plug.in/pages/filesystem-hierarchy-standard.html).

#### Stable release

* [shells_bells.lv2-0.4.0.zip](https://dl.open-music-kontrollers.ch/shells_bells.lv2/stable/shells_bells.lv2-0.4.0.zip) ([sig](https://dl.open-music-kontrollers.ch/shells_bells.lv2/stable/shells_bells.lv2-0.4.0.zip.sig))

#### Unstable (nightly) release

* [shells_bells.lv2-latest-unstable.zip](https://dl.open-music-kontrollers.ch/shells_bells.lv2/unstable/shells_bells.lv2-latest-unstable.zip) ([sig](https://dl.open-music-kontrollers.ch/shells_bells.lv2/unstable/shells_bells.lv2-latest-unstable.zip.sig))

### Sources

#### Stable release

* [shells_bells.lv2-0.4.0.tar.xz](https://git.open-music-kontrollers.ch/lv2/shells_bells.lv2/snapshot/shells_bells.lv2-0.4.0.tar.xz)

#### Git repository

* <https://git.open-music-kontrollers.ch/lv2/shells_bells.lv2>

<!--
### Packages

* [ArchLinux](https://www.archlinux.org/packages/community/x86_64/shells_bells.lv2/)
-->

### Bugs and feature requests

* [Gitlab](https://gitlab.com/OpenMusicKontrollers/shells_bells.lv2)
* [Github](https://github.com/OpenMusicKontrollers/shells_bells.lv2)

#### Plugins

![Screenshot](https://git.open-music-kontrollers.ch/lv2/shells_bells.lv2/plain/screenshots/screenshot_1.png)

##### Bells

Its UI drops you into a shell and whenever you sound the bell, a MIDI note
is played back on its DSP side.

#### Dependencies

* [LV2](http://lv2plug.in) (LV2 Plugin Standard)
* [OpenGl](https://www.opengl.org) (OpenGl)
* [GLEW](http://glew.sourceforge.net) (GLEW)
* [VTERM](http://www.leonerd.org.uk/code/libvterm) (Virtual terminal emulator)

#### Build / install

	git clone https://git.open-music-kontrollers.ch/lv2/shells_bells.lv2
	cd shells_bells.lv2
	meson build
	cd build
	ninja -j4
	ninja test
	sudo ninja install

#### UI

On hi-DPI displays, the UI scales automatically if you have set the correct DPI
in your ~/.Xresources.

    Xft.dpi: 200

If not, you can manually set your DPI via environmental variable *D2TK_SCALE*:

    export D2TK_SCALE=200

#### License

Copyright (c) 2019-2020 Hanspeter Portner (dev@open-music-kontrollers.ch)

This is free software: you can redistribute it and/or modify
it under the terms of the Artistic License 2.0 as published by
The Perl Foundation.

This source is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
Artistic License 2.0 for more details.

You should have received a copy of the Artistic License 2.0
along the source as a COPYING file. If not, obtain it from
<http://www.perlfoundation.org/artistic_license_2_0>.