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
102
103
104
105
|
<div align="center">
<h1><img src="./data/icons/hicolor/scalable/apps/com.raggesilver.BlackBox.svg" height="64"/>Black Box</h1>
<h4>An elegant and customizable terminal for GNOME</h4>
<p>
<a href="#features">Features</a> •
<a href="#install">Install</a> •
<a href="#gallery">Gallery</a> •
<a href="./CHANGELOG.md">Changelog</a>
<br/>
<a href="https://gitlab.gnome.org/raggesilver/blackbox/-/wikis/home">Wiki</a> •
<a href="./COPYING">License</a> •
<a href="./CONTRIBUTING.md">Contributing</a>
</p>
<p>
</p>
</div>
<div align="center">
<img src="https://i.imgur.com/38c2eX4.png" alt="Preview"/><br/>
<small><i>
Black Box 0.14.0 (theme <a href="https://github.com/storm119/Tilix-Themes/blob/master/Themes/japanesque.json" target="_blank">"Japanesque"</a>, fetch <a href="https://github.com/Rosettea/bunnyfetch">bunnyfetch</a>)
</i></small>
<br/><br/>
</div>
## Features
- Color schemes - ([Tilix](https://github.com/gnunn1/tilix) compatible color scheme support)
- Theming - your color scheme can be used to style the whole app
- Background transparency
- Custom fonts, padding, and cell spacing
- Tabs
- Support for drag and dropping files
- Sixel (experimental)
- Customizable keybindings
- Toggle-able header bar
- Search your backlog with text or regex
- Context aware header bar - the header bar changes colors when running commands with sudo and in ssh sessions
- Desktop notifications - get notified when a command is finished in the background
- Customizable UI
## Install
**Flathub**
<a href='https://flathub.org/apps/details/com.raggesilver.BlackBox'><img width='240' alt='Download on Flathub' src='https://flathub.org/assets/badges/flathub-badge-en.svg'/></a>
```bash
flatpak install flathub com.raggesilver.BlackBox
```
**Flatpak Nightly**
You can also download the most recent build. Note that these are _unstable_ and completely unavailable if the latest pipeline failed.
- [Flatpak](https://gitlab.gnome.org/raggesilver/blackbox/-/jobs/artifacts/main/raw/blackbox.flatpak?job=flatpak)
- [Zip](https://gitlab.gnome.org/raggesilver/blackbox/-/jobs/artifacts/main/download?job=flatpak)
**Looking for an older release?**
Check out the [releases page](https://gitlab.gnome.org/raggesilver/blackbox/-/releases).
## Compile
**Flatpak**
To build and run Black Box, use GNOME Builder or VS Code along with [Vala](https://marketplace.visualstudio.com/items?itemName=prince781.vala) and [Flatpak](https://marketplace.visualstudio.com/items?itemName=bilelmoussaoui.flatpak-vscode) extensions.
If you want to build Black Box manually, look at the build script in [.gitlab-ci.yml](./.gitlab-ci.yml).
## Translations
Black Box is accepting translations through Weblate! If you'd like to
contribute with translations, visit the
[Weblate project](https://hosted.weblate.org/projects/blackbox/).
<a href="https://hosted.weblate.org/projects/blackbox/blackbox/">
<img src="https://hosted.weblate.org/widgets/blackbox/-/blackbox/multi-auto.svg" alt="Translation status" />
</a>
## Gallery
> Some of these screenshot are from older versions of Black Box.
<div align="center">
<img src="https://i.imgur.com/O7Nblz8.png" alt="Black Box with 'Show Header bar' off"/><br/>
<small><i>
Black Box with "show header bar" off.
</i></small>
<br/><br/>
<img src="https://i.imgur.com/CNwZhpJ.png" alt="Black Box with 'Show Header bar' off"/><br/>
<small><i>
Black Box with transparent background* and sixel support. *blur is controled
by your compositor.
</i></small>
<br/><br/>
</div>
## Credits
- Most of Black Box's themes come (straight out copied) from [Tilix](https://github.com/gnunn1/tilix)
- Most non-Tilix-default themes come (straight out copied) from [Tilix-Themes](https://github.com/storm119/Tilix-Themes)
- Thank you, @linuxllama, for QA testing and creating Black Box's app icon
- Thank you, @predvodnik, for coming up with the name "Black Box"
- Source code that derives from other projects is properly attributed in the code itself
|
