index.md - sites - public wiki contents of suckless.org
(HTM) git clone git://git.suckless.org/sites
(DIR) Log
(DIR) Files
(DIR) Refs
---
index.md (4855B)
---
1 Alpha Focus Highlight
2 =====================
3 Patch for suckless' simple terminal (`st`), which allows the user to specify two distinct opacity values / background colors; one for the focused- and one for unfocused windows' background.
4 This enables the user to spot the focused window at a glance.
5 The patch is based on the [alpha patch](https://st.suckless.org/patches/alpha/); i.e. is to be
6 applied after applying the alpha patch.
7
8 The patch is released [on this release page](https://github.com/juliusHuelsmann/st/releases) and
9 [on the suckless page](https://st.suckless.org/patches/alpha_focus_highlight/).
10 Please [leave a star](https://github.com/juliusHuelsmann/st-focus).
11
12 Contributions & Bug Reports
13 ---------------------------
14 * [Report / Solve Patching issues](https://github.com/juliusHuelsmann/st) with a new version of `st`
15 * [Contributions and Bug reports](https://github.com/juliusHuelsmann/st-focus)
16
17 Building, customizing and installing the patch
18 ----------------------------------------------
19 **1. Optional Dependencies**
20 The opacity functionality of this patch requires an `X composite manager` (e.g. `picom`, `compton`,
21 `xcompmgr`), which can for instance be installed via `sudo pacman -S picom` on Arch Linux and
22 launched via `picom -b`. *The composite manager has to be relaunched after booting*.
23
24 **2. Applying the patch**
25 Apply the patch to `st`'s source code and build code via `patch < [PATCH_NAME]`
26
27 **3. Customization**
28 This patch performs changes in the `config.def.h` file, which need to be manually merged into a
29 pre-existing custom `config.h` file. The following four variables can be adapted:
30 - `alpha`/`alphaUnfocused` opacity of the terminal when focused / not focused.
31 - `bg`/`bgUnfocused` background color when focused / not focused.
32
33 **4. Build & install** `make; sudo make install`
34
35 Download
36 --------
37 If you want to try out the current version of the patch before patching your own build,
38 check out [this repository](https://github.com/juliusHuelsmann/st), which contains a
39 merged version of this patch with a reasonable configuration.
40
41 The patch comes
42 1. merged into the alpha patch (`alpha + focus`) or
43 2. for patching on top of an already applied alpha patch (`focus`)
44
45 I recommend downloading the alpha patch from the
46 [alpha patch](https://st.suckless.org/patches/alpha/) page and using `Patch: focus`, that way you
47 make sure that you apply the latest version of the alpha patch.
48
49 Note that patch errors can occur when the code in the st repo is updated.
50 Please report an Issue or contribute a merged patch in that case.
51
52 Patch: alpha + focus
53 --------------------
54
55 **st-0.9**
56 - [Version 2(attached)](st-focus-20230610-68d1ad9.diff)
57 - Most recent release [st-focus-20230610-68d1ad9.diff Github](https://github.com/juliusHuelsmann/st/releases/download/alpha_09/st-focus-20230610-68d1ad9.diff)
58
59 **st-0.8.3**
60 - [Version 1 (attached)](st-focus-20200731-43a395a.diff)
61 - Most recent release: [st-focus-20200530-43a395a.diff Github](https://github.com/juliusHuelsmann/st/releases/download/v2/st-focus-20200731-43a395a.diff)
62
63 ---
64
65 Patch: focus
66 ------------
67
68 **st-0.8.3**
69 - [Version 1 (attached)](st-focus-20200731-patch_alpha.diff)
70 - Most recent release: [st-focus-20200530-patch_alpha.diff (Github)](https://github.com/juliusHuelsmann/st/releases/download/v2/st-focus-20200731-patch_alpha.diff)
71
72
73 MISC
74 ----
75 **Note:** The benefit of the `alpha` patch and the `Alpha Focus Highlight` patch are the ability to
76 restrict the transparency only to the background color currently in use, hence keeping the font in
77 the foreground solid and readable.
78
79 If the goal is to apply transparency independent on the content, you do not require any patch for
80 `st`, instead add
81 `
82 inactive-opacity = 0.2;
83 active-opacity = 0.8;
84 `
85 to your `picom` configuration file and keep a vanilla `st` build.
86
87 If you want to configure `inactive-opacity` and `active-opacity` rules in order to apply opacity to
88 other applications, but keep the benefits of the st alpha patches, have a look at
89 [this picom configuration
90 file](https://github.com/juliusHuelsmann/Config/blob/master/.config/picom/picom.conf),
91 in which opacity management configured to be performed by `st`.
92
93 Authors / Contributors
94 ----------------------
95 * Julius Hülsmann - <juliusHuelsmann [at] gmail [dot] com>
96 * [Wim Stockman](https://github.com/wimstockman): Fix erroneous color reset
97 * [glpub](https://github.com/glpub): Fix: erroneous color reset
98 * [Milos Stojanovic](https://github.com/M4444): Code Formatting
99 * [Yui](https://github.com/yuwui): Fix spelling errors
100 * Authors of the shipped alpha patch: [Eon S. Jeon](mailto:esjeon@hyunmu.am), [pr](mailto:protodev@gmx.net), [Laslo Hunhold](mailto:dev@frign.de), [Ivan J.](mailto:parazyd@dyne.org), [Matthew Parnell](mailto:matt@parnmatt.co.uk), [Johannes Mayrhofer](mailto:jm.spam@gmx.net), [Àlex Ramírez](mailto:aramirez@posteo.net)