@fredlackey/devutils 0.0.1 → 0.0.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (257) hide show
  1. package/README.md +5 -5
  2. package/package.json +1 -1
  3. package/src/commands/install.js +374 -36
  4. package/src/installs/adobe-creative-cloud.js +527 -25
  5. package/src/installs/adobe-creative-cloud.md +605 -0
  6. package/src/installs/appcleaner.js +303 -26
  7. package/src/installs/appcleaner.md +699 -0
  8. package/src/installs/apt-transport-https.js +390 -0
  9. package/src/installs/apt-transport-https.md +678 -0
  10. package/src/installs/atomicparsley.js +624 -26
  11. package/src/installs/atomicparsley.md +795 -0
  12. package/src/installs/aws-cli.js +779 -26
  13. package/src/installs/aws-cli.md +727 -0
  14. package/src/installs/balena-etcher.js +688 -26
  15. package/src/installs/balena-etcher.md +761 -0
  16. package/src/installs/bambu-studio.js +912 -26
  17. package/src/installs/bambu-studio.md +780 -0
  18. package/src/installs/bash-completion.js +554 -23
  19. package/src/installs/bash-completion.md +833 -0
  20. package/src/installs/bash.js +399 -26
  21. package/src/installs/bash.md +993 -0
  22. package/src/installs/beyond-compare.js +585 -26
  23. package/src/installs/beyond-compare.md +813 -0
  24. package/src/installs/build-essential.js +511 -26
  25. package/src/installs/build-essential.md +977 -0
  26. package/src/installs/ca-certificates.js +618 -0
  27. package/src/installs/ca-certificates.md +937 -0
  28. package/src/installs/caffeine.js +490 -26
  29. package/src/installs/caffeine.md +839 -0
  30. package/src/installs/camtasia.js +577 -25
  31. package/src/installs/camtasia.md +762 -0
  32. package/src/installs/chatgpt.js +458 -26
  33. package/src/installs/chatgpt.md +814 -0
  34. package/src/installs/chocolatey.js +447 -0
  35. package/src/installs/chocolatey.md +661 -0
  36. package/src/installs/chrome-canary.js +472 -26
  37. package/src/installs/chrome-canary.md +641 -0
  38. package/src/installs/chromium.js +645 -26
  39. package/src/installs/chromium.md +838 -0
  40. package/src/installs/claude-code.js +558 -26
  41. package/src/installs/claude-code.md +1173 -0
  42. package/src/installs/curl.js +361 -26
  43. package/src/installs/curl.md +714 -0
  44. package/src/installs/cursor.js +561 -26
  45. package/src/installs/cursor.md +970 -0
  46. package/src/installs/dbschema.js +674 -26
  47. package/src/installs/dbschema.md +925 -0
  48. package/src/installs/dependencies.md +435 -0
  49. package/src/installs/development-tools.js +600 -0
  50. package/src/installs/development-tools.md +977 -0
  51. package/src/installs/docker.js +1010 -25
  52. package/src/installs/docker.md +1109 -0
  53. package/src/installs/drawio.js +1001 -26
  54. package/src/installs/drawio.md +795 -0
  55. package/src/installs/elmedia-player.js +328 -25
  56. package/src/installs/elmedia-player.md +556 -0
  57. package/src/installs/ffmpeg.js +870 -25
  58. package/src/installs/ffmpeg.md +852 -0
  59. package/src/installs/file.js +464 -0
  60. package/src/installs/file.md +987 -0
  61. package/src/installs/gemini-cli.js +793 -26
  62. package/src/installs/gemini-cli.md +1153 -0
  63. package/src/installs/git.js +382 -26
  64. package/src/installs/git.md +907 -0
  65. package/src/installs/gitego.js +931 -26
  66. package/src/installs/gitego.md +1172 -0
  67. package/src/installs/go.js +913 -26
  68. package/src/installs/go.md +958 -0
  69. package/src/installs/google-chrome.js +801 -25
  70. package/src/installs/google-chrome.md +862 -0
  71. package/src/installs/gpg.js +412 -73
  72. package/src/installs/gpg.md +1056 -0
  73. package/src/installs/homebrew.js +1015 -26
  74. package/src/installs/homebrew.md +988 -0
  75. package/src/installs/imageoptim.js +950 -26
  76. package/src/installs/imageoptim.md +1119 -0
  77. package/src/installs/installers.json +2297 -0
  78. package/src/installs/jq.js +382 -26
  79. package/src/installs/jq.md +809 -0
  80. package/src/installs/keyboard-maestro.js +701 -26
  81. package/src/installs/keyboard-maestro.md +825 -0
  82. package/src/installs/latex.js +771 -26
  83. package/src/installs/latex.md +1095 -0
  84. package/src/installs/lftp.js +338 -26
  85. package/src/installs/lftp.md +907 -0
  86. package/src/installs/lsb-release.js +346 -0
  87. package/src/installs/lsb-release.md +814 -0
  88. package/src/installs/messenger.js +829 -26
  89. package/src/installs/messenger.md +900 -0
  90. package/src/installs/microsoft-office.js +550 -26
  91. package/src/installs/microsoft-office.md +760 -0
  92. package/src/installs/microsoft-teams.js +782 -25
  93. package/src/installs/microsoft-teams.md +886 -0
  94. package/src/installs/node.js +886 -26
  95. package/src/installs/node.md +1153 -0
  96. package/src/installs/nordpass.js +698 -26
  97. package/src/installs/nordpass.md +921 -0
  98. package/src/installs/nvm.js +977 -26
  99. package/src/installs/nvm.md +1057 -0
  100. package/src/installs/openssh.js +734 -64
  101. package/src/installs/openssh.md +1056 -0
  102. package/src/installs/pandoc.js +644 -26
  103. package/src/installs/pandoc.md +1036 -0
  104. package/src/installs/pinentry.js +492 -26
  105. package/src/installs/pinentry.md +1142 -0
  106. package/src/installs/pngyu.js +851 -26
  107. package/src/installs/pngyu.md +896 -0
  108. package/src/installs/postman.js +781 -26
  109. package/src/installs/postman.md +940 -0
  110. package/src/installs/procps.js +425 -0
  111. package/src/installs/procps.md +851 -0
  112. package/src/installs/safari-tech-preview.js +355 -25
  113. package/src/installs/safari-tech-preview.md +533 -0
  114. package/src/installs/sfnt2woff.js +640 -26
  115. package/src/installs/sfnt2woff.md +795 -0
  116. package/src/installs/shellcheck.js +463 -26
  117. package/src/installs/shellcheck.md +1005 -0
  118. package/src/installs/slack.js +722 -25
  119. package/src/installs/slack.md +865 -0
  120. package/src/installs/snagit.js +566 -25
  121. package/src/installs/snagit.md +844 -0
  122. package/src/installs/software-properties-common.js +372 -0
  123. package/src/installs/software-properties-common.md +805 -0
  124. package/src/installs/spotify.js +858 -25
  125. package/src/installs/spotify.md +901 -0
  126. package/src/installs/studio-3t.js +803 -26
  127. package/src/installs/studio-3t.md +918 -0
  128. package/src/installs/sublime-text.js +780 -25
  129. package/src/installs/sublime-text.md +914 -0
  130. package/src/installs/superwhisper.js +687 -25
  131. package/src/installs/superwhisper.md +630 -0
  132. package/src/installs/tailscale.js +727 -26
  133. package/src/installs/tailscale.md +1100 -0
  134. package/src/installs/tar.js +389 -0
  135. package/src/installs/tar.md +946 -0
  136. package/src/installs/termius.js +780 -26
  137. package/src/installs/termius.md +844 -0
  138. package/src/installs/terraform.js +761 -26
  139. package/src/installs/terraform.md +899 -0
  140. package/src/installs/tidal.js +752 -25
  141. package/src/installs/tidal.md +864 -0
  142. package/src/installs/tmux.js +328 -26
  143. package/src/installs/tmux.md +1030 -0
  144. package/src/installs/tree.js +393 -26
  145. package/src/installs/tree.md +833 -0
  146. package/src/installs/unzip.js +460 -0
  147. package/src/installs/unzip.md +879 -0
  148. package/src/installs/vim.js +403 -26
  149. package/src/installs/vim.md +1040 -0
  150. package/src/installs/vlc.js +803 -26
  151. package/src/installs/vlc.md +927 -0
  152. package/src/installs/vscode.js +825 -26
  153. package/src/installs/vscode.md +1002 -0
  154. package/src/installs/wget.js +415 -0
  155. package/src/installs/wget.md +791 -0
  156. package/src/installs/whatsapp.js +710 -25
  157. package/src/installs/whatsapp.md +854 -0
  158. package/src/installs/winpty.js +352 -0
  159. package/src/installs/winpty.md +620 -0
  160. package/src/installs/woff2.js +535 -26
  161. package/src/installs/woff2.md +977 -0
  162. package/src/installs/wsl.js +572 -0
  163. package/src/installs/wsl.md +699 -0
  164. package/src/installs/xcode-clt.js +520 -0
  165. package/src/installs/xcode-clt.md +351 -0
  166. package/src/installs/xcode.js +542 -26
  167. package/src/installs/xcode.md +573 -0
  168. package/src/installs/yarn.js +806 -26
  169. package/src/installs/yarn.md +1074 -0
  170. package/src/installs/yq.js +636 -26
  171. package/src/installs/yq.md +944 -0
  172. package/src/installs/yt-dlp.js +683 -26
  173. package/src/installs/yt-dlp.md +946 -0
  174. package/src/installs/yum-utils.js +297 -0
  175. package/src/installs/yum-utils.md +648 -0
  176. package/src/installs/zoom.js +740 -25
  177. package/src/installs/zoom.md +884 -0
  178. package/src/scripts/README.md +567 -45
  179. package/src/scripts/STATUS.md +208 -0
  180. package/src/scripts/afk.js +395 -7
  181. package/src/scripts/backup-all.js +731 -9
  182. package/src/scripts/backup-source.js +711 -8
  183. package/src/scripts/brewd.js +373 -7
  184. package/src/scripts/brewi.js +505 -9
  185. package/src/scripts/brewr.js +512 -9
  186. package/src/scripts/brews.js +462 -9
  187. package/src/scripts/brewu.js +488 -7
  188. package/src/scripts/c.js +185 -7
  189. package/src/scripts/ccurl.js +325 -8
  190. package/src/scripts/certbot-crontab-init.js +488 -8
  191. package/src/scripts/certbot-init.js +641 -9
  192. package/src/scripts/ch.js +339 -7
  193. package/src/scripts/claude-danger.js +253 -8
  194. package/src/scripts/clean-dev.js +419 -8
  195. package/src/scripts/clear-dns-cache.js +525 -7
  196. package/src/scripts/clone.js +417 -7
  197. package/src/scripts/code-all.js +420 -7
  198. package/src/scripts/count-files.js +195 -8
  199. package/src/scripts/count-folders.js +195 -8
  200. package/src/scripts/count.js +248 -8
  201. package/src/scripts/d.js +203 -7
  202. package/src/scripts/datauri.js +373 -8
  203. package/src/scripts/delete-files.js +363 -7
  204. package/src/scripts/docker-clean.js +410 -8
  205. package/src/scripts/dp.js +426 -7
  206. package/src/scripts/e.js +375 -9
  207. package/src/scripts/empty-trash.js +497 -7
  208. package/src/scripts/evm.js +428 -9
  209. package/src/scripts/fetch-github-repos.js +441 -10
  210. package/src/scripts/get-channel.js +329 -8
  211. package/src/scripts/get-course.js +384 -11
  212. package/src/scripts/get-dependencies.js +290 -9
  213. package/src/scripts/get-folder.js +783 -10
  214. package/src/scripts/get-tunes.js +411 -10
  215. package/src/scripts/get-video.js +352 -9
  216. package/src/scripts/git-backup.js +561 -9
  217. package/src/scripts/git-clone.js +477 -9
  218. package/src/scripts/git-pup.js +303 -7
  219. package/src/scripts/git-push.js +380 -8
  220. package/src/scripts/h.js +607 -9
  221. package/src/scripts/hide-desktop-icons.js +483 -7
  222. package/src/scripts/hide-hidden-files.js +522 -7
  223. package/src/scripts/install-dependencies-from.js +440 -9
  224. package/src/scripts/ips.js +647 -10
  225. package/src/scripts/iso.js +354 -8
  226. package/src/scripts/killni.js +561 -7
  227. package/src/scripts/ll.js +451 -8
  228. package/src/scripts/local-ip.js +310 -8
  229. package/src/scripts/m.js +508 -8
  230. package/src/scripts/map.js +293 -8
  231. package/src/scripts/mkd.js +287 -7
  232. package/src/scripts/ncu-update-all.js +441 -8
  233. package/src/scripts/nginx-init.js +702 -12
  234. package/src/scripts/npmi.js +366 -7
  235. package/src/scripts/o.js +495 -8
  236. package/src/scripts/org-by-date.js +321 -7
  237. package/src/scripts/p.js +208 -7
  238. package/src/scripts/packages.js +313 -8
  239. package/src/scripts/path.js +209 -7
  240. package/src/scripts/ports.js +582 -8
  241. package/src/scripts/q.js +290 -8
  242. package/src/scripts/refresh-files.js +378 -10
  243. package/src/scripts/remove-smaller-files.js +500 -8
  244. package/src/scripts/rename-files-with-date.js +517 -9
  245. package/src/scripts/resize-image.js +523 -9
  246. package/src/scripts/rm-safe.js +653 -8
  247. package/src/scripts/s.js +525 -9
  248. package/src/scripts/set-git-public.js +349 -7
  249. package/src/scripts/show-desktop-icons.js +459 -7
  250. package/src/scripts/show-hidden-files.js +456 -7
  251. package/src/scripts/tpa.js +265 -8
  252. package/src/scripts/tpo.js +264 -7
  253. package/src/scripts/u.js +489 -7
  254. package/src/scripts/vpush.js +422 -8
  255. package/src/scripts/y.js +267 -7
  256. package/src/utils/common/os.js +94 -2
  257. package/src/utils/ubuntu/apt.js +13 -7
@@ -0,0 +1,795 @@
1
+ # Installing Draw.io
2
+
3
+ ## Overview
4
+
5
+ Draw.io (also known as diagrams.net) is a free, open-source diagramming application for creating flowcharts, process diagrams, org charts, UML diagrams, ER diagrams, network diagrams, and more. The desktop application is built on Electron and provides a security-first approach where all diagram data remains local - no data is ever sent externally.
6
+
7
+ Key features:
8
+ - **Offline-first**: Works completely offline after installation
9
+ - **Privacy-focused**: No analytics or external data transmission
10
+ - **Cross-platform**: Available for macOS, Windows, and Linux
11
+ - **Free and open-source**: Licensed under Apache 2.0
12
+
13
+ This guide documents Draw.io Desktop installation across all supported platforms.
14
+
15
+ ## Dependencies
16
+
17
+ ### macOS (Homebrew)
18
+ - **Required:**
19
+ - Homebrew - Install via `/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"` or run `dev install homebrew`
20
+ - **Optional:** None
21
+ - **Auto-installed:** All application dependencies are automatically handled by the Homebrew cask installation process
22
+
23
+ ### Ubuntu (APT/Snap)
24
+ - **Required:**
25
+ - snapd - Install via `sudo apt-get update && sudo apt-get install -y snapd` (automatically installed by the installer if missing)
26
+ - **Optional:** None
27
+ - **Auto-installed:** snapd package manager will be installed automatically if not present via `sudo apt-get install -y snapd`
28
+
29
+ ### Raspberry Pi OS (APT/Snap)
30
+ - **Required:**
31
+ - curl - Install via `sudo apt-get install -y curl` (usually pre-installed)
32
+ - **Optional:**
33
+ - snapd - Install via `sudo apt-get install -y snapd` (preferred installation method, but installer falls back to .deb package if unavailable)
34
+ - **Auto-installed:** When using .deb package fallback, apt will automatically install any missing package dependencies
35
+
36
+ ### Amazon Linux (DNF/YUM)
37
+ - **Required:**
38
+ - wget - Install via `sudo dnf install -y wget` (AL2023) or `sudo yum install -y wget` (AL2)
39
+ - curl - Install via `sudo dnf install -y curl` (AL2023) or `sudo yum install -y curl` (AL2)
40
+ - libxkbfile - Install via `sudo dnf install -y libxkbfile` (AL2023) or `sudo yum install -y libxkbfile` (AL2)
41
+ - libsecret - Install via `sudo dnf install -y libsecret` (AL2023) or `sudo yum install -y libsecret` (AL2)
42
+ - nss - Install via `sudo dnf install -y nss` (AL2023) or `sudo yum install -y nss` (AL2)
43
+ - gtk3 - Install via `sudo dnf install -y gtk3` (AL2023) or `sudo yum install -y gtk3` (AL2)
44
+ - libdrm - Install via `sudo dnf install -y libdrm` (AL2023) or `sudo yum install -y libdrm` (AL2)
45
+ - mesa-libgbm - Install via `sudo dnf install -y mesa-libgbm` (AL2023) or `sudo yum install -y mesa-libgbm` (AL2)
46
+ - alsa-lib - Install via `sudo dnf install -y alsa-lib` (AL2023) or `sudo yum install -y alsa-lib` (AL2)
47
+ - **Optional:** None
48
+ - **Auto-installed:** None (all dependencies must be manually installed before running Draw.io)
49
+
50
+ ### Windows (Chocolatey/winget)
51
+ - **Required:**
52
+ - Chocolatey - Install via PowerShell (Administrator): `Set-ExecutionPolicy Bypass -Scope Process -Force; [System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072; iex ((New-Object System.Net.WebClient).DownloadString('https://community.chocolatey.org/install.ps1'))`
53
+ - **Optional:** None
54
+ - **Auto-installed:** All application dependencies are automatically handled by the Chocolatey package installation process
55
+
56
+ ### Git Bash (Manual/Portable)
57
+ - **Required:**
58
+ - curl - Usually pre-installed with Git for Windows
59
+ - **Optional:**
60
+ - unzip - Install via Git for Windows package manager or use PowerShell's Expand-Archive as fallback
61
+ - **Auto-installed:** None
62
+
63
+ ## Prerequisites
64
+
65
+ Before installing Draw.io on any platform, ensure:
66
+
67
+ 1. **Internet connectivity** - Required to download installation packages
68
+ 2. **Administrative privileges** - Required for system-wide installation
69
+ 3. **Sufficient disk space** - Approximately 500 MB free space recommended
70
+
71
+ ## Platform-Specific Installation
72
+
73
+ ### macOS (Homebrew)
74
+
75
+ #### Prerequisites
76
+
77
+ - macOS 12 (Monterey) or later
78
+ - Homebrew package manager installed
79
+ - Apple Silicon (M1/M2/M3/M4) or Intel processor
80
+
81
+ If Homebrew is not installed, install it first:
82
+
83
+ ```bash
84
+ /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
85
+ ```
86
+
87
+ #### Installation Steps
88
+
89
+ Run the following command to install Draw.io Desktop:
90
+
91
+ ```bash
92
+ brew install --quiet --cask drawio
93
+ ```
94
+
95
+ The `--quiet` flag suppresses non-essential output, and `--cask` specifies the graphical application version. Homebrew automatically detects your processor architecture (Intel or Apple Silicon) and installs the appropriate version.
96
+
97
+ #### Verification
98
+
99
+ Confirm the installation succeeded by launching the application:
100
+
101
+ ```bash
102
+ open -a "draw.io"
103
+ ```
104
+
105
+ Alternatively, verify the application exists:
106
+
107
+ ```bash
108
+ ls /Applications | grep -i draw
109
+ ```
110
+
111
+ Expected output:
112
+
113
+ ```
114
+ draw.io.app
115
+ ```
116
+
117
+ #### Troubleshooting
118
+
119
+ **Problem**: `Error: Cask 'drawio' is not installed`
120
+
121
+ **Solution**: The cask name may have changed. Search for the current name:
122
+
123
+ ```bash
124
+ brew search drawio
125
+ ```
126
+
127
+ **Problem**: Application fails to open with "damaged" warning
128
+
129
+ **Solution**: Remove the quarantine attribute:
130
+
131
+ ```bash
132
+ xattr -cr /Applications/draw.io.app
133
+ ```
134
+
135
+ **Problem**: Homebrew is not in PATH after installation
136
+
137
+ **Solution**: Add Homebrew to your PATH. For Apple Silicon Macs:
138
+
139
+ ```bash
140
+ echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile
141
+ eval "$(/opt/homebrew/bin/brew shellenv)"
142
+ ```
143
+
144
+ ---
145
+
146
+ ### Ubuntu/Debian (Snap)
147
+
148
+ #### Prerequisites
149
+
150
+ - Ubuntu 16.04 LTS or later, or Debian 9 or later
151
+ - snapd package manager (pre-installed on Ubuntu 16.04+)
152
+ - sudo privileges
153
+
154
+ Snap is the recommended installation method for Ubuntu/Debian as it provides automatic updates and consistent behavior across distributions.
155
+
156
+ First, ensure snapd is installed and up to date:
157
+
158
+ ```bash
159
+ sudo DEBIAN_FRONTEND=noninteractive apt-get update -y
160
+ sudo DEBIAN_FRONTEND=noninteractive apt-get install -y snapd
161
+ ```
162
+
163
+ #### Installation Steps
164
+
165
+ Run the following command to install Draw.io:
166
+
167
+ ```bash
168
+ sudo snap install drawio
169
+ ```
170
+
171
+ Snap handles all dependencies automatically and will keep Draw.io updated in the background.
172
+
173
+ #### Verification
174
+
175
+ Confirm the installation succeeded:
176
+
177
+ ```bash
178
+ snap list drawio
179
+ ```
180
+
181
+ Expected output (version numbers may vary):
182
+
183
+ ```
184
+ Name Version Rev Tracking Publisher Notes
185
+ drawio 28.2.5 123 latest/stable jgraph -
186
+ ```
187
+
188
+ Launch Draw.io to verify it works:
189
+
190
+ ```bash
191
+ drawio &
192
+ ```
193
+
194
+ Or from the application menu, search for "draw.io" or "diagrams.net".
195
+
196
+ #### Troubleshooting
197
+
198
+ **Problem**: `error: snap "drawio" is not available on stable for this architecture`
199
+
200
+ **Solution**: The Snap package may not support your CPU architecture. Use the alternative .deb installation method:
201
+
202
+ ```bash
203
+ # Download the latest .deb package
204
+ curl -s https://api.github.com/repos/jgraph/drawio-desktop/releases/latest | grep "browser_download_url.*amd64.*\.deb" | cut -d '"' -f 4 | xargs -I {} curl -L -o /tmp/drawio.deb {}
205
+ # Install the package
206
+ sudo DEBIAN_FRONTEND=noninteractive apt-get install -y /tmp/drawio.deb
207
+ ```
208
+
209
+ **Problem**: Draw.io cannot access files in certain directories
210
+
211
+ **Solution**: Snap applications have limited file system access by default. Grant additional permissions:
212
+
213
+ ```bash
214
+ sudo snap connect drawio:removable-media
215
+ ```
216
+
217
+ **Problem**: `snap: command not found`
218
+
219
+ **Solution**: Install snapd:
220
+
221
+ ```bash
222
+ sudo DEBIAN_FRONTEND=noninteractive apt-get update -y
223
+ sudo DEBIAN_FRONTEND=noninteractive apt-get install -y snapd
224
+ sudo systemctl enable --now snapd.socket
225
+ sudo ln -s /var/lib/snapd/snap /snap
226
+ ```
227
+
228
+ Log out and log back in for PATH changes to take effect.
229
+
230
+ ---
231
+
232
+ ### Raspberry Pi OS (Snap or Manual)
233
+
234
+ #### Prerequisites
235
+
236
+ - Raspberry Pi OS (64-bit recommended) - Bookworm or Bullseye
237
+ - Raspberry Pi 3B+ or later (64-bit capable hardware)
238
+ - At least 2 GB RAM
239
+ - sudo privileges
240
+
241
+ First, verify your architecture:
242
+
243
+ ```bash
244
+ uname -m
245
+ ```
246
+
247
+ - `aarch64` = 64-bit (recommended, more packages available)
248
+ - `armv7l` = 32-bit (limited package availability)
249
+
250
+ **Important**: Draw.io Desktop ARM64 packages are available from GitHub releases. Snap packages may have limited ARM support.
251
+
252
+ #### Installation Steps
253
+
254
+ **For 64-bit Raspberry Pi OS (aarch64):**
255
+
256
+ Install via Snap (if available for your architecture):
257
+
258
+ ```bash
259
+ # Install and configure snapd
260
+ sudo DEBIAN_FRONTEND=noninteractive apt-get update -y
261
+ sudo DEBIAN_FRONTEND=noninteractive apt-get install -y snapd
262
+ sudo reboot
263
+ ```
264
+
265
+ After reboot:
266
+
267
+ ```bash
268
+ sudo snap install core
269
+ sudo snap install drawio
270
+ ```
271
+
272
+ **Alternative: Install from .deb package (Recommended for ARM64):**
273
+
274
+ If Snap does not work on your architecture, download and install the ARM64 .deb package directly:
275
+
276
+ ```bash
277
+ # Download the latest ARM64 .deb package
278
+ curl -s https://api.github.com/repos/jgraph/drawio-desktop/releases/latest | grep "browser_download_url.*arm64.*\.deb" | cut -d '"' -f 4 | xargs -I {} curl -L -o /tmp/drawio-arm64.deb {}
279
+
280
+ # Install the package and resolve dependencies
281
+ sudo DEBIAN_FRONTEND=noninteractive apt-get update -y
282
+ sudo DEBIAN_FRONTEND=noninteractive apt-get install -y /tmp/drawio-arm64.deb
283
+ ```
284
+
285
+ **For 32-bit Raspberry Pi OS (armv7l):**
286
+
287
+ Draw.io Desktop does not officially provide 32-bit ARM packages. Use the web version instead:
288
+
289
+ 1. Open Chromium browser on your Raspberry Pi
290
+ 2. Navigate to https://app.diagrams.net
291
+ 3. The web application provides the same functionality as the desktop app
292
+
293
+ #### Verification
294
+
295
+ For Snap installation:
296
+
297
+ ```bash
298
+ snap list drawio
299
+ ```
300
+
301
+ For .deb installation:
302
+
303
+ ```bash
304
+ dpkg -l | grep drawio
305
+ ```
306
+
307
+ Launch Draw.io:
308
+
309
+ ```bash
310
+ drawio &
311
+ ```
312
+
313
+ #### Troubleshooting
314
+
315
+ **Problem**: Snap installation fails with architecture error
316
+
317
+ **Solution**: Use the .deb package installation method described above for ARM64, or use the web version for 32-bit systems.
318
+
319
+ **Problem**: Application is slow or unresponsive
320
+
321
+ **Solution**: Draw.io is an Electron application which can be resource-intensive. Ensure you have adequate RAM (2 GB minimum, 4 GB recommended) and consider closing other applications.
322
+
323
+ **Problem**: Dependency errors when installing .deb package
324
+
325
+ **Solution**: Fix broken dependencies:
326
+
327
+ ```bash
328
+ sudo DEBIAN_FRONTEND=noninteractive apt-get install -y -f
329
+ ```
330
+
331
+ ---
332
+
333
+ ### Amazon Linux (RPM Manual Installation)
334
+
335
+ #### Prerequisites
336
+
337
+ - Amazon Linux 2023 (AL2023) or Amazon Linux 2 (AL2)
338
+ - sudo privileges
339
+ - curl and wget installed
340
+
341
+ **Note**: Draw.io is not available in Amazon Linux's default repositories. Install the RPM package directly from GitHub releases.
342
+
343
+ #### Installation Steps
344
+
345
+ **For Amazon Linux 2023 (DNF):**
346
+
347
+ ```bash
348
+ # Install required dependencies
349
+ sudo dnf install -y wget curl libxkbfile libsecret nss
350
+
351
+ # Download the latest x86_64 RPM package
352
+ curl -s https://api.github.com/repos/jgraph/drawio-desktop/releases/latest | grep "browser_download_url.*x86_64.*\.rpm" | cut -d '"' -f 4 | xargs -I {} curl -L -o /tmp/drawio.rpm {}
353
+
354
+ # Install the package
355
+ sudo dnf install -y /tmp/drawio.rpm
356
+ ```
357
+
358
+ **For Amazon Linux 2 (YUM):**
359
+
360
+ ```bash
361
+ # Install required dependencies
362
+ sudo yum install -y wget curl libxkbfile libsecret nss
363
+
364
+ # Download the latest x86_64 RPM package
365
+ curl -s https://api.github.com/repos/jgraph/drawio-desktop/releases/latest | grep "browser_download_url.*x86_64.*\.rpm" | cut -d '"' -f 4 | xargs -I {} curl -L -o /tmp/drawio.rpm {}
366
+
367
+ # Install the package
368
+ sudo yum install -y /tmp/drawio.rpm
369
+ ```
370
+
371
+ #### Verification
372
+
373
+ Confirm the installation succeeded:
374
+
375
+ ```bash
376
+ rpm -qa | grep drawio
377
+ ```
378
+
379
+ Expected output (version numbers may vary):
380
+
381
+ ```
382
+ drawio-29.2.9-1.x86_64
383
+ ```
384
+
385
+ Launch Draw.io (requires X11 display):
386
+
387
+ ```bash
388
+ drawio &
389
+ ```
390
+
391
+ #### Troubleshooting
392
+
393
+ **Problem**: Missing library dependencies
394
+
395
+ **Solution**: Install common Electron dependencies:
396
+
397
+ ```bash
398
+ # For AL2023
399
+ sudo dnf install -y gtk3 libdrm mesa-libgbm alsa-lib
400
+
401
+ # For AL2
402
+ sudo yum install -y gtk3 libdrm mesa-libgbm alsa-lib
403
+ ```
404
+
405
+ **Problem**: "cannot open display" error
406
+
407
+ **Solution**: Draw.io is a GUI application requiring a graphical environment. On headless servers, use X11 forwarding:
408
+
409
+ ```bash
410
+ ssh -X user@amazon-linux-host
411
+ drawio &
412
+ ```
413
+
414
+ Or use the web version at https://app.diagrams.net for server environments.
415
+
416
+ **Problem**: RPM verification fails
417
+
418
+ **Solution**: Import the GPG key or skip verification (less secure):
419
+
420
+ ```bash
421
+ sudo rpm --import https://github.com/jgraph.gpg
422
+ # Or skip verification
423
+ sudo rpm -ivh --nosignature /tmp/drawio.rpm
424
+ ```
425
+
426
+ ---
427
+
428
+ ### Windows (Chocolatey)
429
+
430
+ #### Prerequisites
431
+
432
+ - Windows 10 version 1809 or later (64-bit), or Windows 11
433
+ - Administrator PowerShell or Command Prompt
434
+ - Chocolatey package manager installed
435
+
436
+ If Chocolatey is not installed, install it first by running this command in an Administrator PowerShell:
437
+
438
+ ```powershell
439
+ Set-ExecutionPolicy Bypass -Scope Process -Force; [System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072; iex ((New-Object System.Net.WebClient).DownloadString('https://community.chocolatey.org/install.ps1'))
440
+ ```
441
+
442
+ #### Installation Steps
443
+
444
+ Run the following command in an Administrator PowerShell or Command Prompt:
445
+
446
+ ```powershell
447
+ choco install drawio -y
448
+ ```
449
+
450
+ The `-y` flag automatically confirms all prompts, enabling fully non-interactive installation. The Chocolatey package uses the `/S` (silent) flag internally for the installer.
451
+
452
+ #### Verification
453
+
454
+ Confirm the installation succeeded:
455
+
456
+ ```powershell
457
+ choco list drawio
458
+ ```
459
+
460
+ Expected output (version numbers may vary):
461
+
462
+ ```
463
+ drawio 29.2.9
464
+ 1 packages installed.
465
+ ```
466
+
467
+ Launch Draw.io from the Start Menu or via command line:
468
+
469
+ ```powershell
470
+ start "" "C:\Program Files\draw.io\draw.io.exe"
471
+ ```
472
+
473
+ #### Troubleshooting
474
+
475
+ **Problem**: Installation fails with access denied error
476
+
477
+ **Solution**: Ensure you are running PowerShell or Command Prompt as Administrator. Right-click the terminal icon and select "Run as administrator".
478
+
479
+ **Problem**: `choco: command not found`
480
+
481
+ **Solution**: Chocolatey was not installed correctly or PATH was not updated. Close and reopen PowerShell, or reinstall Chocolatey.
482
+
483
+ **Problem**: Application does not appear after installation
484
+
485
+ **Solution**: The installer may require a system restart. If that does not help, verify the installation:
486
+
487
+ ```powershell
488
+ Get-ChildItem "C:\Program Files\draw.io"
489
+ ```
490
+
491
+ ---
492
+
493
+ ### WSL (Ubuntu)
494
+
495
+ #### Prerequisites
496
+
497
+ - Windows 10 version 2004 or higher, or Windows 11
498
+ - WSL 2 enabled with Ubuntu distribution installed
499
+ - sudo privileges within WSL
500
+ - X11 server running on Windows (for GUI applications)
501
+
502
+ **Important**: Draw.io is a GUI application. Running it in WSL requires an X11 server on Windows to display the window.
503
+
504
+ #### Installation Steps
505
+
506
+ **Step 1: Install an X11 server on Windows**
507
+
508
+ Install VcXsrv or similar X11 server on Windows:
509
+
510
+ ```powershell
511
+ # Run in Windows PowerShell as Administrator
512
+ choco install vcxsrv -y
513
+ ```
514
+
515
+ Launch XLaunch from the Start Menu with default settings (Multiple windows, Start no client, Disable access control).
516
+
517
+ **Step 2: Configure WSL for X11 display**
518
+
519
+ In WSL Ubuntu, configure the DISPLAY variable:
520
+
521
+ ```bash
522
+ # For WSL 2
523
+ echo 'export DISPLAY=$(grep -m 1 nameserver /etc/resolv.conf | awk "{print \$2}"):0' >> ~/.bashrc
524
+ source ~/.bashrc
525
+ ```
526
+
527
+ **Step 3: Install Draw.io via Snap**
528
+
529
+ ```bash
530
+ # Install snapd if not present
531
+ sudo DEBIAN_FRONTEND=noninteractive apt-get update -y
532
+ sudo DEBIAN_FRONTEND=noninteractive apt-get install -y snapd
533
+
534
+ # Install Draw.io
535
+ sudo snap install drawio
536
+ ```
537
+
538
+ #### Verification
539
+
540
+ Confirm the installation succeeded:
541
+
542
+ ```bash
543
+ snap list drawio
544
+ ```
545
+
546
+ Launch Draw.io (ensure X11 server is running on Windows):
547
+
548
+ ```bash
549
+ drawio &
550
+ ```
551
+
552
+ A Draw.io window should appear on your Windows desktop.
553
+
554
+ #### Troubleshooting
555
+
556
+ **Problem**: `Error: cannot open display`
557
+
558
+ **Solution**: Ensure the X11 server is running on Windows and DISPLAY is set correctly:
559
+
560
+ ```bash
561
+ echo $DISPLAY
562
+ ```
563
+
564
+ If empty or incorrect, set it manually:
565
+
566
+ ```bash
567
+ export DISPLAY=$(grep -m 1 nameserver /etc/resolv.conf | awk '{print $2}'):0
568
+ ```
569
+
570
+ **Problem**: Snap does not work in WSL
571
+
572
+ **Solution**: Snap requires systemd which is not enabled by default in WSL. Enable systemd:
573
+
574
+ ```bash
575
+ echo -e "[boot]\nsystemd=true" | sudo tee /etc/wsl.conf
576
+ ```
577
+
578
+ Then restart WSL from Windows PowerShell:
579
+
580
+ ```powershell
581
+ wsl --shutdown
582
+ ```
583
+
584
+ Re-open WSL and retry the Snap installation.
585
+
586
+ **Problem**: Window appears but is blank or crashes
587
+
588
+ **Solution**: Try running with software rendering:
589
+
590
+ ```bash
591
+ drawio --disable-gpu &
592
+ ```
593
+
594
+ ---
595
+
596
+ ### Git Bash (Windows Portable Installation)
597
+
598
+ #### Prerequisites
599
+
600
+ - Windows 10 or Windows 11 (64-bit)
601
+ - Git Bash installed (comes with Git for Windows)
602
+ - Internet connection to download the portable package
603
+
604
+ **Note**: Git Bash runs on Windows, so the primary installation method is the Windows Chocolatey installation (see Windows section). However, if you cannot use Chocolatey or need a portable installation, follow these steps.
605
+
606
+ #### Installation Steps
607
+
608
+ Download and extract the portable Windows ZIP package:
609
+
610
+ ```bash
611
+ # Create a directory for portable applications
612
+ mkdir -p ~/portable-apps
613
+
614
+ # Download the latest Windows ZIP (portable version)
615
+ curl -L -o /tmp/drawio.zip "$(curl -s https://api.github.com/repos/jgraph/drawio-desktop/releases/latest | grep 'browser_download_url.*windows\.zip' | head -1 | cut -d '"' -f 4)"
616
+
617
+ # Extract to portable apps directory
618
+ unzip -q /tmp/drawio.zip -d ~/portable-apps/drawio
619
+
620
+ # Clean up
621
+ rm /tmp/drawio.zip
622
+ ```
623
+
624
+ Add an alias for easy access from Git Bash:
625
+
626
+ ```bash
627
+ echo 'alias drawio="~/portable-apps/drawio/draw.io.exe"' >> ~/.bashrc
628
+ source ~/.bashrc
629
+ ```
630
+
631
+ #### Verification
632
+
633
+ Confirm the installation succeeded:
634
+
635
+ ```bash
636
+ ls ~/portable-apps/drawio/
637
+ ```
638
+
639
+ Expected output should include `draw.io.exe` and supporting files.
640
+
641
+ Launch Draw.io:
642
+
643
+ ```bash
644
+ drawio &
645
+ ```
646
+
647
+ Or directly:
648
+
649
+ ```bash
650
+ ~/portable-apps/drawio/draw.io.exe &
651
+ ```
652
+
653
+ #### Troubleshooting
654
+
655
+ **Problem**: `unzip: command not found`
656
+
657
+ **Solution**: Install unzip via Git Bash's package manager or use Windows built-in extraction:
658
+
659
+ ```bash
660
+ # Alternative using PowerShell from Git Bash
661
+ powershell -command "Expand-Archive -Path '/tmp/drawio.zip' -DestinationPath '$HOME/portable-apps/drawio'"
662
+ ```
663
+
664
+ **Problem**: Permission denied when running the executable
665
+
666
+ **Solution**: Windows may have blocked the downloaded file. Unblock it:
667
+
668
+ ```bash
669
+ powershell -command "Unblock-File -Path '$HOME/portable-apps/drawio/draw.io.exe'"
670
+ ```
671
+
672
+ **Problem**: PATH issues with spaces in directory names
673
+
674
+ **Solution**: Ensure the path is quoted correctly in aliases and commands. Use Windows-style paths if needed:
675
+
676
+ ```bash
677
+ alias drawio='"/c/Users/YourName/portable-apps/drawio/draw.io.exe"'
678
+ ```
679
+
680
+ ---
681
+
682
+ ## Post-Installation Configuration
683
+
684
+ After installing Draw.io on any platform, consider these optional configurations.
685
+
686
+ ### Setting Default File Format
687
+
688
+ Draw.io supports multiple file formats. To set a default:
689
+
690
+ 1. Open Draw.io
691
+ 2. Go to File > Properties
692
+ 3. Set your preferred default format (`.drawio`, `.drawio.xml`, `.drawio.svg`, `.drawio.png`)
693
+
694
+ ### Configuring Automatic Updates
695
+
696
+ **macOS (Homebrew)**: Updates are manual. Run periodically:
697
+
698
+ ```bash
699
+ brew upgrade --cask drawio
700
+ ```
701
+
702
+ **Linux (Snap)**: Updates are automatic via snapd.
703
+
704
+ **Windows (Chocolatey)**: Run periodically:
705
+
706
+ ```powershell
707
+ choco upgrade drawio -y
708
+ ```
709
+
710
+ ### Disabling Update Checks
711
+
712
+ If you prefer to control updates manually, you can disable automatic update checks:
713
+
714
+ 1. Open Draw.io
715
+ 2. Go to Help > Check for Updates
716
+ 3. Disable automatic checking
717
+
718
+ ### Integrating with Version Control
719
+
720
+ Draw.io files (`.drawio`) are XML-based and can be version-controlled with Git. For better diff support:
721
+
722
+ 1. Save diagrams as `.drawio.svg` or `.drawio.png` for visual diffs
723
+ 2. Or use `.drawio.xml` for text-based diffs
724
+
725
+ ---
726
+
727
+ ## Common Issues
728
+
729
+ ### Issue: Application Takes Long Time to Start
730
+
731
+ **Symptoms**: Draw.io shows a blank window or loading indicator for an extended period.
732
+
733
+ **Solutions**:
734
+
735
+ - Disable hardware acceleration: Launch with `--disable-gpu` flag
736
+ - Clear application cache (location varies by platform)
737
+ - Ensure sufficient system resources are available
738
+
739
+ ### Issue: Cannot Open Files from Network Drives
740
+
741
+ **Symptoms**: Error when trying to open diagrams stored on network shares.
742
+
743
+ **Solutions**:
744
+
745
+ - Copy the file locally first, then open it
746
+ - On Linux Snap installations, connect the removable-media interface:
747
+
748
+ ```bash
749
+ sudo snap connect drawio:removable-media
750
+ ```
751
+
752
+ ### Issue: Export to PDF Fails
753
+
754
+ **Symptoms**: PDF export produces blank or corrupted files.
755
+
756
+ **Solutions**:
757
+
758
+ - Ensure the diagram is not empty
759
+ - Try exporting to PNG first, then convert to PDF
760
+ - Update to the latest version of Draw.io
761
+
762
+ ### Issue: Fonts Appear Incorrect
763
+
764
+ **Symptoms**: Diagram text uses incorrect or fallback fonts.
765
+
766
+ **Solutions**:
767
+
768
+ - Install the required fonts on your system
769
+ - Use web-safe fonts for maximum compatibility
770
+ - Embed fonts when exporting (File > Export As > Advanced Options)
771
+
772
+ ### Issue: Slow Performance with Large Diagrams
773
+
774
+ **Symptoms**: Application becomes sluggish with complex diagrams.
775
+
776
+ **Solutions**:
777
+
778
+ - Split large diagrams into multiple pages
779
+ - Reduce the use of complex shapes and gradients
780
+ - Increase available system memory
781
+ - Disable "Connection Arrows" for complex diagrams
782
+
783
+ ---
784
+
785
+ ## References
786
+
787
+ - [Draw.io Official Website](https://www.drawio.com/)
788
+ - [Draw.io Desktop GitHub Repository](https://github.com/jgraph/drawio-desktop)
789
+ - [Draw.io Desktop Releases](https://github.com/jgraph/drawio-desktop/releases)
790
+ - [Homebrew Cask - drawio](https://formulae.brew.sh/cask/drawio)
791
+ - [Snap Store - drawio](https://snapcraft.io/drawio)
792
+ - [Chocolatey Package - drawio](https://community.chocolatey.org/packages/drawio)
793
+ - [Draw.io Desktop Documentation](https://www.drawio.com/blog/diagrams-offline)
794
+ - [Installing Snap on Raspberry Pi OS](https://snapcraft.io/docs/installing-snap-on-raspbian)
795
+ - [Draw.io Silent Installation Guide](https://silentinstallhq.com/draw-io-silent-install-how-to-guide/)