36 |
37 |
38 | ## Writing Code
39 |
40 | Before writing code, make sure you have followed [these instructions](#plan-ahead).
41 |
42 | ### Setup
43 |
44 | I recommend using [Visual Studio Code](https://code.visualstudio.com/) with the
45 | following extensions:
46 |
47 | - [Vala](https://marketplace.visualstudio.com/items?itemName=prince781.vala)
48 | - [Editorconfig](https://marketplace.visualstudio.com/items?itemName=EditorConfig.EditorConfig)
49 | - [Flatpak](https://marketplace.visualstudio.com/items?itemName=bilelmoussaoui.flatpak-vscode)
50 |
51 | ### Code Style
52 |
53 | Black Box follows the Prettier code style as much as possible. With one
54 | exception: brace style.
55 |
56 | ```vala
57 | public class Terminal.YourClass : YourParent {
58 | construct {
59 | // ...
60 | }
61 |
62 | public YourClass () {
63 | Object ();
64 |
65 | this.notify ["my-change"].connect (this.my_callback);
66 | }
67 |
68 | private void my_callback (
69 | int x,
70 | int y,
71 | int n_times
72 | ) {
73 | if (x < 0) {
74 | // ...
75 | }
76 | else if (x > 9) {
77 | // ...
78 | }
79 | else {
80 | // ...
81 | try {
82 | // ...
83 | }
84 | catch (Error e) {
85 | // ...
86 | }
87 | }
88 | }
89 | }
90 | ```
91 |
92 | ### Reactivity
93 |
94 | Avoid using `notify` to update the UI as much as possible. Using
95 | [GLib.Settings.bind](https://valadoc.org/gio-2.0/GLib.Settings.bind.html),
96 | [GLib.Settings.bind_with_mapping](https://valadoc.org/gio-2.0/GLib.Settings.bind_with_mapping.html),
97 | or [GLib.Object.bind_property](https://valadoc.org/gobject-2.0/GLib.Object.bind_property.html)
98 | is preferred.
99 |
100 | ### Warnings
101 |
102 | Do your best not to introduce new compilation or runtime warnings to the app.
103 | Warnings make it harder to debug errors and give users the impression that the
104 | app is not working as it should.
105 |
--------------------------------------------------------------------------------
/src/widgets/HeaderBar.vala:
--------------------------------------------------------------------------------
1 | /* HeaderBar.vala
2 | *
3 | * Copyright 2022 Paulo Queiroz
2 |
3 |
17 |
18 |
25 |
26 | ## Features
27 |
28 | - Color schemes - ([Tilix](https://github.com/gnunn1/tilix) compatible color scheme support)
29 | - Theming - your color scheme can be used to style the whole app
30 | - Background transparency
31 | - Custom fonts, padding, and cell spacing
32 | - Tabs
33 | - Support for drag and dropping files
34 | - Sixel (experimental)
35 | - Customizable keybindings
36 | - Toggle-able header bar
37 | - Search your backlog with text or regex
38 | - Context aware header bar - the header bar changes colors when running commands with sudo and in ssh sessions
39 | - Desktop notifications - get notified when a command is finished in the background
40 | - Customizable UI
41 |
42 | ## Install
43 |
44 | **Flathub**
45 |
46 | 
Black Box
3 | An elegant and customizable terminal for GNOME
4 |
5 | Features •
6 | Install •
7 | Gallery •
8 | Changelog
9 |
10 | Wiki •
11 | License •
12 | Contributing
13 |
15 |
16 |
47 |
48 | ```bash
49 | flatpak install flathub com.raggesilver.BlackBox
50 | ```
51 |
52 | **Flatpak Nightly**
53 |
54 | You can also download the most recent build. Note that these are _unstable_ and completely unavailable if the latest pipeline failed.
55 |
56 | - [Flatpak](https://gitlab.gnome.org/raggesilver/blackbox/-/jobs/artifacts/main/raw/blackbox.flatpak?job=flatpak)
57 | - [Zip](https://gitlab.gnome.org/raggesilver/blackbox/-/jobs/artifacts/main/download?job=flatpak)
58 |
59 | **Looking for an older release?**
60 |
61 | Check out the [releases page](https://gitlab.gnome.org/raggesilver/blackbox/-/releases).
62 |
63 | ## Compile
64 |
65 | **Flatpak**
66 |
67 | 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.
68 |
69 | If you want to build Black Box manually, look at the build script in [.gitlab-ci.yml](./.gitlab-ci.yml).
70 |
71 | ## Translations
72 |
73 | Black Box is accepting translations through Weblate! If you'd like to
74 | contribute with translations, visit the
75 | [Weblate project](https://hosted.weblate.org/projects/blackbox/).
76 |
77 |
78 |
79 |
80 |
81 | ## Gallery
82 |
83 | > Some of these screenshot are from older versions of Black Box.
84 |
85 |
86 | 
87 | 88 | Black Box with "show header bar" off. 89 | 90 |
91 |
92 | 93 | Black Box with transparent background* and sixel support. *blur is controled 94 | by your compositor. 95 | 96 |
97 |
98 |
99 | ## Credits
100 |
101 | - Most of Black Box's themes come (straight out copied) from [Tilix](https://github.com/gnunn1/tilix)
102 | - Most non-Tilix-default themes come (straight out copied) from [Tilix-Themes](https://github.com/storm119/Tilix-Themes)
103 | - Thank you, @linuxllama, for QA testing and creating Black Box's app icon
104 | - Thank you, @predvodnik, for coming up with the name "Black Box"
105 | - Source code that derives from other projects is properly attributed in the code itself
106 |
--------------------------------------------------------------------------------
/src/CommandLine.vala:
--------------------------------------------------------------------------------
1 | /* CommandLine.vala
2 | *
3 | * Copyright 2022 Paulo Queiroz 87 | 88 | Black Box with "show header bar" off. 89 | 90 |
91 |
92 | 93 | Black Box with transparent background* and sixel support. *blur is controled 94 | by your compositor. 95 | 96 |
97 |
The Sandbox Conundrum, patch 1.
35 |Features
36 |-
37 |
- Added shortcut for moving tabs Shift+Ctrl+PageDown/PageUp. 38 |
- Ctrl+PageDown/PageUp have been added as default keybindins for switching tabs, alongside (Shift)+Ctrl+Tab (yes, there are two default keybindings). You may need to reset keybindings for these two actions to see the new defaults. 39 |
- The window title is now set to the title of the active tab. This is noticeable when hovering Black Box in the GNOME Overview 40 |
- Black Box will show a visual indicator on a tab when a command finishes in the background (similar to desktop notifications, but less noisy) 41 |
Improvements
43 |-
44 |
- Command completion notifications have been improved. Clicking a notification will now focus the correct tab. Black Box will no longer emit two notifications for the same command. 45 |