quickTerminal/FIRST_READ.txt at main · LEVOGNE/quickTerminal · GitHub

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
╔══════════════════════════════════════════════════════════════╗
║                    SystemTrayTerminal                        ║
║              A blazing-fast terminal for macOS               ║
╚══════════════════════════════════════════════════════════════╝


  BEFORE YOU START
  ════════════════

  macOS blocks apps from unidentified developers by default.
  SystemTrayTerminal is not signed with an Apple Developer certificate,
  so you need to remove the quarantine flag ONCE before launching.


  OPTION 1 — Use the installer (recommended)
  ───────────────────────────────────────────

  Open Terminal.app and run:

      bash install.sh

  This removes the quarantine flag, optionally copies the app
  to /Applications, and launches SystemTrayTerminal.


  OPTION 2 — Do it manually
  ─────────────────────────

  Open Terminal.app and run:

      xattr -cr SystemTrayTerminal.app

  Then double-click SystemTrayTerminal.app to launch.


  WHAT DOES xattr -cr DO?
  ───────────────────────

  When you download a file from the internet, macOS adds a
  "quarantine" attribute. This flag tells Gatekeeper to block
  the app. The command simply removes that flag — nothing else.
  It is completely safe and only needs to be done once.


  AFTER FIRST LAUNCH
  ──────────────────

  SystemTrayTerminal lives in your menu bar (no dock icon).
  Press Ctrl + < to toggle the terminal window.
  Double-tap Ctrl to open the quickBAR command palette.


  UPDATES
  ───────

  SystemTrayTerminal checks for updates automatically every 72 hours.
  You can also check manually via quickBAR → "Check for Updates".
  Updates preserve all your tabs, splits, settings, and working directories.


  MORE INFO
  ─────────

  GitHub:   https://github.com/LEVOGNE/SystemTrayTerminal
  License:  Free for personal use, commercial license required for businesses
            See LICENSE file for details
  Author:   LEVOGNE — Levent Ersen (l.ersen@icloud.com)