@fredlackey/devutils 0.0.18 → 0.0.19

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 (331) hide show
  1. package/README.md +32 -150
  2. package/package.json +5 -82
  3. package/bin/dev.js +0 -16
  4. package/files/README.md +0 -0
  5. package/files/claude/.claude/commands/setup-context.md +0 -3
  6. package/files/monorepos/_archive/README.md +0 -36
  7. package/files/monorepos/_legacy/README.md +0 -36
  8. package/files/monorepos/ai-docs/README.md +0 -33
  9. package/files/monorepos/apps/README.md +0 -24
  10. package/files/monorepos/docs/README.md +0 -40
  11. package/files/monorepos/packages/README.md +0 -25
  12. package/files/monorepos/research/README.md +0 -29
  13. package/files/monorepos/scripts/README.md +0 -24
  14. package/src/cli.js +0 -72
  15. package/src/commands/README.md +0 -41
  16. package/src/commands/configure.js +0 -199
  17. package/src/commands/identity.js +0 -1630
  18. package/src/commands/ignore.js +0 -247
  19. package/src/commands/install.js +0 -526
  20. package/src/commands/setup.js +0 -246
  21. package/src/commands/status.js +0 -223
  22. package/src/commands/update.js +0 -142
  23. package/src/commands/version.js +0 -100
  24. package/src/completion.js +0 -284
  25. package/src/constants.js +0 -45
  26. package/src/ignore/claude-code.txt +0 -10
  27. package/src/ignore/docker.txt +0 -18
  28. package/src/ignore/linux.txt +0 -23
  29. package/src/ignore/macos.txt +0 -36
  30. package/src/ignore/node.txt +0 -55
  31. package/src/ignore/terraform.txt +0 -37
  32. package/src/ignore/vscode.txt +0 -18
  33. package/src/ignore/windows.txt +0 -35
  34. package/src/index.js +0 -0
  35. package/src/installs/README.md +0 -399
  36. package/src/installs/adobe-creative-cloud.js +0 -546
  37. package/src/installs/adobe-creative-cloud.md +0 -605
  38. package/src/installs/appcleaner.js +0 -321
  39. package/src/installs/appcleaner.md +0 -699
  40. package/src/installs/apt-transport-https.js +0 -390
  41. package/src/installs/apt-transport-https.md +0 -678
  42. package/src/installs/atomicparsley.js +0 -642
  43. package/src/installs/atomicparsley.md +0 -795
  44. package/src/installs/aws-cli.js +0 -797
  45. package/src/installs/aws-cli.md +0 -727
  46. package/src/installs/balena-etcher.js +0 -710
  47. package/src/installs/balena-etcher.md +0 -761
  48. package/src/installs/bambu-studio.js +0 -1143
  49. package/src/installs/bambu-studio.md +0 -780
  50. package/src/installs/bash-completion.js +0 -575
  51. package/src/installs/bash-completion.md +0 -833
  52. package/src/installs/bash.js +0 -417
  53. package/src/installs/bash.md +0 -993
  54. package/src/installs/beyond-compare.js +0 -603
  55. package/src/installs/beyond-compare.md +0 -813
  56. package/src/installs/brave-browser.js +0 -968
  57. package/src/installs/brave-browser.md +0 -650
  58. package/src/installs/build-essential.js +0 -529
  59. package/src/installs/build-essential.md +0 -977
  60. package/src/installs/ca-certificates.js +0 -618
  61. package/src/installs/ca-certificates.md +0 -937
  62. package/src/installs/caffeine.js +0 -508
  63. package/src/installs/caffeine.md +0 -839
  64. package/src/installs/camtasia.js +0 -596
  65. package/src/installs/camtasia.md +0 -762
  66. package/src/installs/chatgpt.js +0 -476
  67. package/src/installs/chatgpt.md +0 -814
  68. package/src/installs/chocolatey.js +0 -456
  69. package/src/installs/chocolatey.md +0 -661
  70. package/src/installs/chrome-canary.js +0 -419
  71. package/src/installs/chrome-canary.md +0 -641
  72. package/src/installs/chromium.js +0 -667
  73. package/src/installs/chromium.md +0 -838
  74. package/src/installs/claude-code.js +0 -576
  75. package/src/installs/claude-code.md +0 -1173
  76. package/src/installs/cloudflare-warp.js +0 -900
  77. package/src/installs/cloudflare-warp.md +0 -1047
  78. package/src/installs/comet-browser.js +0 -588
  79. package/src/installs/comet-browser.md +0 -731
  80. package/src/installs/curl.js +0 -379
  81. package/src/installs/curl.md +0 -714
  82. package/src/installs/cursor.js +0 -579
  83. package/src/installs/cursor.md +0 -970
  84. package/src/installs/dbeaver.js +0 -924
  85. package/src/installs/dbeaver.md +0 -939
  86. package/src/installs/dbschema.js +0 -692
  87. package/src/installs/dbschema.md +0 -925
  88. package/src/installs/dependencies.md +0 -453
  89. package/src/installs/development-tools.js +0 -600
  90. package/src/installs/development-tools.md +0 -977
  91. package/src/installs/docker.js +0 -1029
  92. package/src/installs/docker.md +0 -1109
  93. package/src/installs/drawio.js +0 -1019
  94. package/src/installs/drawio.md +0 -795
  95. package/src/installs/elmedia-player.js +0 -347
  96. package/src/installs/elmedia-player.md +0 -556
  97. package/src/installs/ffmpeg.js +0 -889
  98. package/src/installs/ffmpeg.md +0 -852
  99. package/src/installs/file.js +0 -464
  100. package/src/installs/file.md +0 -987
  101. package/src/installs/gemini-cli.js +0 -811
  102. package/src/installs/gemini-cli.md +0 -1153
  103. package/src/installs/git.js +0 -400
  104. package/src/installs/git.md +0 -907
  105. package/src/installs/gitego.js +0 -949
  106. package/src/installs/gitego.md +0 -1172
  107. package/src/installs/go.js +0 -931
  108. package/src/installs/go.md +0 -958
  109. package/src/installs/google-antigravity.js +0 -913
  110. package/src/installs/google-antigravity.md +0 -1075
  111. package/src/installs/google-chrome.js +0 -833
  112. package/src/installs/google-chrome.md +0 -862
  113. package/src/installs/gpg.js +0 -480
  114. package/src/installs/gpg.md +0 -1056
  115. package/src/installs/homebrew.js +0 -1028
  116. package/src/installs/homebrew.md +0 -988
  117. package/src/installs/imageoptim.js +0 -968
  118. package/src/installs/imageoptim.md +0 -1119
  119. package/src/installs/installers.json +0 -4032
  120. package/src/installs/installers.json.tmp +0 -3953
  121. package/src/installs/jq.js +0 -400
  122. package/src/installs/jq.md +0 -809
  123. package/src/installs/keyboard-maestro.js +0 -719
  124. package/src/installs/keyboard-maestro.md +0 -825
  125. package/src/installs/kiro.js +0 -864
  126. package/src/installs/kiro.md +0 -1015
  127. package/src/installs/latex.js +0 -789
  128. package/src/installs/latex.md +0 -1095
  129. package/src/installs/lftp.js +0 -356
  130. package/src/installs/lftp.md +0 -907
  131. package/src/installs/lsb-release.js +0 -346
  132. package/src/installs/lsb-release.md +0 -814
  133. package/src/installs/messenger.js +0 -847
  134. package/src/installs/messenger.md +0 -900
  135. package/src/installs/microsoft-office.js +0 -568
  136. package/src/installs/microsoft-office.md +0 -760
  137. package/src/installs/microsoft-teams.js +0 -801
  138. package/src/installs/microsoft-teams.md +0 -886
  139. package/src/installs/moom.js +0 -326
  140. package/src/installs/moom.md +0 -570
  141. package/src/installs/node.js +0 -904
  142. package/src/installs/node.md +0 -1153
  143. package/src/installs/nordpass.js +0 -716
  144. package/src/installs/nordpass.md +0 -921
  145. package/src/installs/nordvpn.js +0 -892
  146. package/src/installs/nordvpn.md +0 -1052
  147. package/src/installs/nvm.js +0 -995
  148. package/src/installs/nvm.md +0 -1057
  149. package/src/installs/ohmyzsh.js +0 -529
  150. package/src/installs/ohmyzsh.md +0 -1094
  151. package/src/installs/openssh.js +0 -804
  152. package/src/installs/openssh.md +0 -1056
  153. package/src/installs/pandoc.js +0 -662
  154. package/src/installs/pandoc.md +0 -1036
  155. package/src/installs/parallels-desktop.js +0 -431
  156. package/src/installs/parallels-desktop.md +0 -446
  157. package/src/installs/pinentry.js +0 -510
  158. package/src/installs/pinentry.md +0 -1142
  159. package/src/installs/pngyu.js +0 -869
  160. package/src/installs/pngyu.md +0 -896
  161. package/src/installs/postman.js +0 -799
  162. package/src/installs/postman.md +0 -940
  163. package/src/installs/procps.js +0 -425
  164. package/src/installs/procps.md +0 -851
  165. package/src/installs/safari-tech-preview.js +0 -374
  166. package/src/installs/safari-tech-preview.md +0 -533
  167. package/src/installs/sfnt2woff.js +0 -658
  168. package/src/installs/sfnt2woff.md +0 -795
  169. package/src/installs/shellcheck.js +0 -481
  170. package/src/installs/shellcheck.md +0 -1005
  171. package/src/installs/slack.js +0 -741
  172. package/src/installs/slack.md +0 -865
  173. package/src/installs/snagit.js +0 -585
  174. package/src/installs/snagit.md +0 -844
  175. package/src/installs/software-properties-common.js +0 -372
  176. package/src/installs/software-properties-common.md +0 -805
  177. package/src/installs/spotify.js +0 -877
  178. package/src/installs/spotify.md +0 -901
  179. package/src/installs/studio-3t.js +0 -823
  180. package/src/installs/studio-3t.md +0 -918
  181. package/src/installs/sublime-text.js +0 -804
  182. package/src/installs/sublime-text.md +0 -914
  183. package/src/installs/superwhisper.js +0 -706
  184. package/src/installs/superwhisper.md +0 -630
  185. package/src/installs/tailscale.js +0 -745
  186. package/src/installs/tailscale.md +0 -1100
  187. package/src/installs/tar.js +0 -389
  188. package/src/installs/tar.md +0 -946
  189. package/src/installs/termius.js +0 -798
  190. package/src/installs/termius.md +0 -844
  191. package/src/installs/terraform.js +0 -779
  192. package/src/installs/terraform.md +0 -899
  193. package/src/installs/tfenv.js +0 -778
  194. package/src/installs/tfenv.md +0 -1091
  195. package/src/installs/tidal.js +0 -771
  196. package/src/installs/tidal.md +0 -864
  197. package/src/installs/tmux.js +0 -346
  198. package/src/installs/tmux.md +0 -1030
  199. package/src/installs/tree.js +0 -411
  200. package/src/installs/tree.md +0 -833
  201. package/src/installs/unzip.js +0 -460
  202. package/src/installs/unzip.md +0 -879
  203. package/src/installs/vim.js +0 -421
  204. package/src/installs/vim.md +0 -1040
  205. package/src/installs/vlc.js +0 -821
  206. package/src/installs/vlc.md +0 -927
  207. package/src/installs/vscode.js +0 -843
  208. package/src/installs/vscode.md +0 -1002
  209. package/src/installs/wget.js +0 -420
  210. package/src/installs/wget.md +0 -791
  211. package/src/installs/whatsapp.js +0 -729
  212. package/src/installs/whatsapp.md +0 -854
  213. package/src/installs/winpty.js +0 -352
  214. package/src/installs/winpty.md +0 -620
  215. package/src/installs/woff2.js +0 -553
  216. package/src/installs/woff2.md +0 -977
  217. package/src/installs/wsl.js +0 -572
  218. package/src/installs/wsl.md +0 -699
  219. package/src/installs/xcode-clt.js +0 -520
  220. package/src/installs/xcode-clt.md +0 -351
  221. package/src/installs/xcode.js +0 -560
  222. package/src/installs/xcode.md +0 -573
  223. package/src/installs/yarn.js +0 -824
  224. package/src/installs/yarn.md +0 -1074
  225. package/src/installs/yq.js +0 -654
  226. package/src/installs/yq.md +0 -944
  227. package/src/installs/yt-dlp.js +0 -701
  228. package/src/installs/yt-dlp.md +0 -946
  229. package/src/installs/yum-utils.js +0 -297
  230. package/src/installs/yum-utils.md +0 -648
  231. package/src/installs/zoom.js +0 -759
  232. package/src/installs/zoom.md +0 -884
  233. package/src/installs/zsh.js +0 -455
  234. package/src/installs/zsh.md +0 -1008
  235. package/src/scripts/README.md +0 -617
  236. package/src/scripts/STATUS.md +0 -208
  237. package/src/scripts/afk.js +0 -411
  238. package/src/scripts/backup-all.js +0 -746
  239. package/src/scripts/backup-source.js +0 -727
  240. package/src/scripts/brewd.js +0 -389
  241. package/src/scripts/brewi.js +0 -520
  242. package/src/scripts/brewr.js +0 -527
  243. package/src/scripts/brews.js +0 -477
  244. package/src/scripts/brewu.js +0 -504
  245. package/src/scripts/c.js +0 -201
  246. package/src/scripts/ccurl.js +0 -341
  247. package/src/scripts/certbot-crontab-init.js +0 -504
  248. package/src/scripts/certbot-init.js +0 -657
  249. package/src/scripts/ch.js +0 -355
  250. package/src/scripts/claude-danger.js +0 -268
  251. package/src/scripts/clean-dev.js +0 -435
  252. package/src/scripts/clear-dns-cache.js +0 -541
  253. package/src/scripts/clone.js +0 -435
  254. package/src/scripts/code-all.js +0 -437
  255. package/src/scripts/count-files.js +0 -211
  256. package/src/scripts/count-folders.js +0 -211
  257. package/src/scripts/count.js +0 -264
  258. package/src/scripts/d.js +0 -219
  259. package/src/scripts/datauri.js +0 -389
  260. package/src/scripts/delete-files.js +0 -380
  261. package/src/scripts/docker-clean.js +0 -426
  262. package/src/scripts/dp.js +0 -442
  263. package/src/scripts/e.js +0 -390
  264. package/src/scripts/empty-trash.js +0 -513
  265. package/src/scripts/evm.js +0 -444
  266. package/src/scripts/fetch-github-repos.js +0 -456
  267. package/src/scripts/get-channel.js +0 -345
  268. package/src/scripts/get-course.js +0 -399
  269. package/src/scripts/get-dependencies.js +0 -306
  270. package/src/scripts/get-folder.js +0 -799
  271. package/src/scripts/get-tunes.js +0 -426
  272. package/src/scripts/get-video.js +0 -367
  273. package/src/scripts/git-backup.js +0 -577
  274. package/src/scripts/git-clone.js +0 -493
  275. package/src/scripts/git-pup.js +0 -319
  276. package/src/scripts/git-push.js +0 -396
  277. package/src/scripts/h.js +0 -622
  278. package/src/scripts/hide-desktop-icons.js +0 -499
  279. package/src/scripts/hide-hidden-files.js +0 -538
  280. package/src/scripts/install-dependencies-from.js +0 -456
  281. package/src/scripts/ips.js +0 -663
  282. package/src/scripts/iso.js +0 -370
  283. package/src/scripts/killni.js +0 -577
  284. package/src/scripts/ll.js +0 -467
  285. package/src/scripts/local-ip.js +0 -325
  286. package/src/scripts/m.js +0 -524
  287. package/src/scripts/map.js +0 -309
  288. package/src/scripts/mkd.js +0 -351
  289. package/src/scripts/ncu-update-all.js +0 -457
  290. package/src/scripts/nginx-init.js +0 -718
  291. package/src/scripts/npmi.js +0 -382
  292. package/src/scripts/o.js +0 -511
  293. package/src/scripts/org-by-date.js +0 -338
  294. package/src/scripts/p.js +0 -224
  295. package/src/scripts/packages.js +0 -330
  296. package/src/scripts/path.js +0 -225
  297. package/src/scripts/ports.js +0 -597
  298. package/src/scripts/q.js +0 -305
  299. package/src/scripts/refresh-files.js +0 -394
  300. package/src/scripts/remove-smaller-files.js +0 -516
  301. package/src/scripts/rename-files-with-date.js +0 -533
  302. package/src/scripts/resize-image.js +0 -539
  303. package/src/scripts/rm-safe.js +0 -669
  304. package/src/scripts/s.js +0 -540
  305. package/src/scripts/set-git-public.js +0 -365
  306. package/src/scripts/show-desktop-icons.js +0 -475
  307. package/src/scripts/show-hidden-files.js +0 -472
  308. package/src/scripts/tpa.js +0 -280
  309. package/src/scripts/tpo.js +0 -280
  310. package/src/scripts/u.js +0 -505
  311. package/src/scripts/vpush.js +0 -437
  312. package/src/scripts/y.js +0 -283
  313. package/src/utils/README.md +0 -95
  314. package/src/utils/common/apps.js +0 -143
  315. package/src/utils/common/display.js +0 -157
  316. package/src/utils/common/network.js +0 -185
  317. package/src/utils/common/os.js +0 -294
  318. package/src/utils/common/package-manager.js +0 -301
  319. package/src/utils/common/privileges.js +0 -138
  320. package/src/utils/common/shell.js +0 -261
  321. package/src/utils/macos/apps.js +0 -228
  322. package/src/utils/macos/brew.js +0 -315
  323. package/src/utils/ubuntu/apt.js +0 -307
  324. package/src/utils/ubuntu/desktop.js +0 -292
  325. package/src/utils/ubuntu/snap.js +0 -344
  326. package/src/utils/ubuntu/systemd.js +0 -286
  327. package/src/utils/windows/choco.js +0 -465
  328. package/src/utils/windows/env.js +0 -246
  329. package/src/utils/windows/registry.js +0 -269
  330. package/src/utils/windows/shell.js +0 -240
  331. package/src/utils/windows/winget.js +0 -489
@@ -1,710 +0,0 @@
1
- #!/usr/bin/env node
2
-
3
- /**
4
- * @fileoverview Install Balena Etcher - a powerful OS image flasher for SD cards and USB drives.
5
- * @module installs/balena-etcher
6
- *
7
- * Balena Etcher is a GUI application that safely flashes OS images to SD cards and USB drives.
8
- * It validates writes to ensure data integrity and includes safeguards against accidental
9
- * overwrites of system drives.
10
- *
11
- * Supported platforms:
12
- * - macOS: Homebrew cask
13
- * - Ubuntu/Debian: Direct .deb download from GitHub
14
- * - Raspberry Pi OS: Pi-Apps (requires 64-bit)
15
- * - Amazon Linux/RHEL: Direct .rpm download from GitHub
16
- * - Windows: Chocolatey or winget
17
- * - WSL: Direct .deb download (requires WSLg for GUI)
18
- * - Git Bash: Uses Windows Chocolatey
19
- */
20
-
21
- const fs = require('fs');
22
- const path = require('path');
23
- const os = require('../utils/common/os');
24
- const shell = require('../utils/common/shell');
25
- const brew = require('../utils/macos/brew');
26
- const apt = require('../utils/ubuntu/apt');
27
- const choco = require('../utils/windows/choco');
28
- const winget = require('../utils/windows/winget');
29
- const macosApps = require('../utils/macos/apps');
30
-
31
- /**
32
- * Whether this installer requires a desktop environment to function.
33
- * Balena Etcher is a GUI application for flashing OS images.
34
- */
35
- const REQUIRES_DESKTOP = true;
36
-
37
- /**
38
- * The current version of Balena Etcher to install when downloading directly.
39
- * Update this value when a new version is released.
40
- */
41
- const ETCHER_VERSION = '2.1.4';
42
-
43
- /**
44
- * Download URLs for direct installation methods (non-package-manager installs).
45
- */
46
- const DOWNLOAD_URLS = {
47
- deb: `https://github.com/balena-io/etcher/releases/download/v${ETCHER_VERSION}/balena-etcher_${ETCHER_VERSION}_amd64.deb`,
48
- rpm: `https://github.com/balena-io/etcher/releases/download/v${ETCHER_VERSION}/balena-etcher-${ETCHER_VERSION}-1.x86_64.rpm`
49
- };
50
-
51
- /**
52
- * Checks if Balena Etcher is already installed on macOS by looking for the application bundle.
53
- * @returns {boolean} True if balenaEtcher.app exists in /Applications
54
- */
55
- function isInstalledOnMacOS() {
56
- return macosApps.isAppInstalled('balenaEtcher');
57
- }
58
-
59
- /**
60
- * Checks if Balena Etcher is already installed on Debian-based systems.
61
- * Uses dpkg to query the package database.
62
- * @returns {Promise<boolean>} True if the balena-etcher package is installed
63
- */
64
- async function isInstalledOnDebian() {
65
- return apt.isPackageInstalled('balena-etcher');
66
- }
67
-
68
- /**
69
- * Checks if Balena Etcher is already installed on RPM-based systems.
70
- * Uses rpm to query the package database.
71
- * @returns {Promise<boolean>} True if the balena-etcher package is installed
72
- */
73
- async function isInstalledOnRPM() {
74
- const result = await shell.exec('rpm -q balena-etcher 2>/dev/null');
75
- return result.code === 0;
76
- }
77
-
78
- /**
79
- * Checks if Balena Etcher is already installed on Windows.
80
- * Checks the standard installation directory.
81
- * @returns {Promise<boolean>} True if balenaEtcher.exe exists in Program Files
82
- */
83
- async function isInstalledOnWindows() {
84
- // Check common installation paths
85
- const result = await shell.exec('powershell -Command "Test-Path \'C:\\Program Files\\balenaEtcher\\balenaEtcher.exe\'"');
86
- return result.stdout.trim().toLowerCase() === 'true';
87
- }
88
-
89
- /**
90
- * Checks if Balena Etcher is installed on Raspberry Pi via Pi-Apps.
91
- * Looks for the balena-etcher-electron binary.
92
- * @returns {Promise<boolean>} True if the binary exists
93
- */
94
- async function isInstalledOnRaspbian() {
95
- // Pi-Apps installs to /usr/bin/balena-etcher-electron
96
- return shell.commandExists('balena-etcher-electron') || shell.commandExists('balena-etcher');
97
- }
98
-
99
- /**
100
- * Install Balena Etcher on macOS using Homebrew Cask.
101
- *
102
- * Prerequisites:
103
- * - macOS 10.15 (Catalina) or later
104
- * - Homebrew package manager installed
105
- *
106
- * @returns {Promise<void>}
107
- */
108
- async function install_macos() {
109
- // Check if Homebrew is available
110
- if (!brew.isInstalled()) {
111
- console.log('Homebrew is not installed. Please install Homebrew first:');
112
- console.log(' /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"');
113
- return;
114
- }
115
-
116
- // Check if already installed (idempotency check)
117
- if (isInstalledOnMacOS()) {
118
- console.log('Balena Etcher is already installed.');
119
- return;
120
- }
121
-
122
- console.log('Installing Balena Etcher via Homebrew Cask...');
123
-
124
- // Install using the brew cask command
125
- // Using --quiet to suppress non-essential output for cleaner automation
126
- const result = await brew.installCask('balenaetcher');
127
-
128
- if (!result.success) {
129
- console.error('Failed to install Balena Etcher:', result.output);
130
- return;
131
- }
132
-
133
- // Verify installation succeeded
134
- if (isInstalledOnMacOS()) {
135
- console.log('Balena Etcher installed successfully.');
136
- console.log('Location: /Applications/balenaEtcher.app');
137
- } else {
138
- console.error('Installation completed but Balena Etcher was not found in /Applications.');
139
- }
140
- }
141
-
142
- /**
143
- * Install Balena Etcher on Ubuntu/Debian using direct .deb download.
144
- *
145
- * The official APT repository is deprecated, so we download the .deb package
146
- * directly from GitHub releases.
147
- *
148
- * Prerequisites:
149
- * - Ubuntu 18.04+ or Debian 10+ (64-bit)
150
- * - sudo privileges
151
- * - wget installed
152
- *
153
- * @returns {Promise<void>}
154
- */
155
- async function install_ubuntu() {
156
- // Check architecture FIRST - Balena Etcher only provides AMD64 packages for Linux
157
- // This must be checked before attempting any installations
158
- const arch = os.getArch();
159
- if (arch !== 'x64') {
160
- console.log(`Balena Etcher does not provide official ${arch} packages for Ubuntu/Debian.`);
161
- console.log('');
162
- console.log('Note: Official Balena Etcher releases only support x64 (AMD64) architecture.');
163
- console.log('For ARM64 systems:');
164
- console.log(' - Raspberry Pi: Use Pi-Apps (community ARM build)');
165
- console.log(' - Other ARM64 Linux: Community builds available at:');
166
- console.log(' https://github.com/Itai-Nelken/BalenaEtcher-arm');
167
- console.log('');
168
- console.log('Alternatively, consider using Raspberry Pi Imager (official ARM support):');
169
- console.log(' sudo apt-get install -y rpi-imager');
170
- return;
171
- }
172
-
173
- // Check if already installed (idempotency check)
174
- const alreadyInstalled = await isInstalledOnDebian();
175
- if (alreadyInstalled) {
176
- console.log('Balena Etcher is already installed.');
177
- return;
178
- }
179
-
180
- // Ensure wget is available for downloading
181
- if (!shell.commandExists('wget')) {
182
- console.log('Installing wget (required for download)...');
183
- // Update package lists first
184
- await shell.exec('sudo DEBIAN_FRONTEND=noninteractive apt-get update -y');
185
- const wgetResult = await shell.exec('sudo DEBIAN_FRONTEND=noninteractive apt-get install -y wget');
186
- if (wgetResult.code !== 0) {
187
- console.error('Failed to install wget:', wgetResult.stderr);
188
- return;
189
- }
190
- }
191
-
192
- console.log('Downloading Balena Etcher .deb package...');
193
-
194
- // Download the .deb package to /tmp
195
- const downloadResult = await shell.exec(
196
- `wget -q -O /tmp/balena-etcher.deb "${DOWNLOAD_URLS.deb}"`
197
- );
198
-
199
- if (downloadResult.code !== 0) {
200
- console.error('Failed to download Balena Etcher:', downloadResult.stderr);
201
- return;
202
- }
203
-
204
- console.log('Installing Balena Etcher...');
205
-
206
- // Update package lists first to ensure dependencies can be resolved
207
- // This is important for fresh systems where package lists may be stale
208
- await shell.exec('sudo DEBIAN_FRONTEND=noninteractive apt-get update -y');
209
-
210
- // Install the .deb package using apt-get
211
- // DEBIAN_FRONTEND=noninteractive ensures no interactive prompts
212
- const installResult = await shell.exec(
213
- 'sudo DEBIAN_FRONTEND=noninteractive apt-get install -y /tmp/balena-etcher.deb'
214
- );
215
-
216
- // Clean up the downloaded file regardless of installation outcome
217
- await shell.exec('rm -f /tmp/balena-etcher.deb');
218
-
219
- if (installResult.code !== 0) {
220
- console.error('Failed to install Balena Etcher:', installResult.stderr);
221
- // Attempt to fix broken dependencies
222
- console.log('Attempting to fix broken dependencies...');
223
- await shell.exec('sudo DEBIAN_FRONTEND=noninteractive apt-get install -f -y');
224
- return;
225
- }
226
-
227
- // Verify installation succeeded
228
- const verifyInstalled = await isInstalledOnDebian();
229
- if (verifyInstalled) {
230
- console.log('Balena Etcher installed successfully.');
231
- console.log('Launch with: balena-etcher');
232
- } else {
233
- console.error('Installation completed but Balena Etcher package was not found.');
234
- }
235
- }
236
-
237
- /**
238
- * Install Balena Etcher on Raspberry Pi OS using Pi-Apps.
239
- *
240
- * IMPORTANT: Balena Etcher does NOT have an official ARM installer.
241
- * Pi-Apps provides a community-compiled ARM64 version.
242
- *
243
- * Prerequisites:
244
- * - Raspberry Pi OS (64-bit only - aarch64)
245
- * - Raspberry Pi 3, 4, or 5
246
- * - Desktop environment
247
- *
248
- * @returns {Promise<void>}
249
- */
250
- async function install_raspbian() {
251
- // Check if already installed (idempotency check)
252
- const alreadyInstalled = await isInstalledOnRaspbian();
253
- if (alreadyInstalled) {
254
- console.log('Balena Etcher is already installed.');
255
- return;
256
- }
257
-
258
- // Verify we are running on 64-bit Raspberry Pi OS
259
- // Balena Etcher ARM builds only support aarch64
260
- const archResult = await shell.exec('uname -m');
261
- const architecture = archResult.stdout.trim();
262
-
263
- if (architecture !== 'aarch64') {
264
- console.log('Balena Etcher requires 64-bit Raspberry Pi OS (aarch64).');
265
- console.log(`Current architecture: ${architecture}`);
266
- console.log('Please install 64-bit Raspberry Pi OS from:');
267
- console.log(' https://www.raspberrypi.com/software/operating-systems/');
268
- return;
269
- }
270
-
271
- // Check if Pi-Apps is already installed
272
- const homeDir = os.getHomeDir();
273
- const piAppsPath = path.join(homeDir, 'pi-apps', 'manage');
274
- const piAppsInstalled = fs.existsSync(piAppsPath);
275
-
276
- if (!piAppsInstalled) {
277
- console.log('Installing Pi-Apps (required for Balena Etcher on Raspberry Pi)...');
278
-
279
- // Install Pi-Apps from the official repository
280
- const piAppsResult = await shell.exec(
281
- 'wget -qO- https://raw.githubusercontent.com/Botspot/pi-apps/master/install | bash'
282
- );
283
-
284
- if (piAppsResult.code !== 0) {
285
- console.error('Failed to install Pi-Apps:', piAppsResult.stderr);
286
- console.log('You may need to install required dependencies first:');
287
- console.log(' sudo apt-get update && sudo apt-get install -y yad curl wget');
288
- return;
289
- }
290
- }
291
-
292
- console.log('Installing Balena Etcher via Pi-Apps...');
293
-
294
- // Install Balena Etcher using Pi-Apps CLI
295
- // Note: The app name in Pi-Apps is 'BalenaEtcher' (case-sensitive)
296
- const installResult = await shell.exec(
297
- `"${piAppsPath}" install 'BalenaEtcher'`
298
- );
299
-
300
- if (installResult.code !== 0) {
301
- console.error('Failed to install Balena Etcher via Pi-Apps:', installResult.stderr);
302
- return;
303
- }
304
-
305
- // Verify installation succeeded
306
- const verifyInstalled = await isInstalledOnRaspbian();
307
- if (verifyInstalled) {
308
- console.log('Balena Etcher installed successfully.');
309
- console.log('Launch with: balena-etcher-electron');
310
- } else {
311
- console.error('Installation completed but Balena Etcher was not found.');
312
- }
313
- }
314
-
315
- /**
316
- * Install Balena Etcher on Amazon Linux/RHEL using direct .rpm download.
317
- *
318
- * Prerequisites:
319
- * - Amazon Linux 2023, Amazon Linux 2, RHEL 8+, or Fedora 35+
320
- * - 64-bit (x86_64) architecture
321
- * - sudo privileges
322
- * - Desktop environment (for GUI operation)
323
- *
324
- * @returns {Promise<void>}
325
- */
326
- async function install_amazon_linux() {
327
- // Check architecture FIRST - Balena Etcher only provides x86_64 packages for Linux
328
- // This must be checked before attempting any installations
329
- const arch = os.getArch();
330
- if (arch !== 'x64') {
331
- console.log(`Balena Etcher does not provide official ${arch} packages for RHEL/Fedora/Amazon Linux.`);
332
- console.log('');
333
- console.log('Note: Official Balena Etcher releases only support x64 (x86_64) architecture.');
334
- console.log('For ARM64 systems, community builds may be available at:');
335
- console.log(' https://github.com/Itai-Nelken/BalenaEtcher-arm');
336
- console.log('');
337
- console.log('Alternatively, consider using other image writing tools with ARM support.');
338
- return;
339
- }
340
-
341
- // Check if already installed (idempotency check)
342
- const alreadyInstalled = await isInstalledOnRPM();
343
- if (alreadyInstalled) {
344
- console.log('Balena Etcher is already installed.');
345
- return;
346
- }
347
-
348
- // Ensure wget is available for downloading
349
- if (!shell.commandExists('wget')) {
350
- console.log('Installing wget (required for download)...');
351
- // Detect whether to use dnf or yum
352
- const packageManager = shell.commandExists('dnf') ? 'dnf' : 'yum';
353
- const wgetResult = await shell.exec(`sudo ${packageManager} install -y wget`);
354
- if (wgetResult.code !== 0) {
355
- console.error('Failed to install wget:', wgetResult.stderr);
356
- return;
357
- }
358
- }
359
-
360
- console.log('Downloading Balena Etcher .rpm package...');
361
-
362
- // Download the .rpm package to /tmp
363
- const downloadResult = await shell.exec(
364
- `wget -q -O /tmp/balena-etcher.rpm "${DOWNLOAD_URLS.rpm}"`
365
- );
366
-
367
- if (downloadResult.code !== 0) {
368
- console.error('Failed to download Balena Etcher:', downloadResult.stderr);
369
- return;
370
- }
371
-
372
- console.log('Installing Balena Etcher...');
373
-
374
- // Determine which package manager to use (dnf preferred over yum)
375
- const packageManager = shell.commandExists('dnf') ? 'dnf' : 'yum';
376
-
377
- // Install the .rpm package
378
- const installResult = await shell.exec(
379
- `sudo ${packageManager} install -y /tmp/balena-etcher.rpm`
380
- );
381
-
382
- // Clean up the downloaded file regardless of installation outcome
383
- await shell.exec('rm -f /tmp/balena-etcher.rpm');
384
-
385
- if (installResult.code !== 0) {
386
- console.error('Failed to install Balena Etcher:', installResult.stderr);
387
- console.log('You may need to install missing dependencies:');
388
- console.log(' sudo dnf install -y libXScrnSaver gtk3 nss alsa-lib');
389
- return;
390
- }
391
-
392
- // Verify installation succeeded
393
- const verifyInstalled = await isInstalledOnRPM();
394
- if (verifyInstalled) {
395
- console.log('Balena Etcher installed successfully.');
396
- console.log('Launch with: balena-etcher');
397
- } else {
398
- console.error('Installation completed but Balena Etcher package was not found.');
399
- }
400
- }
401
-
402
- /**
403
- * Install Balena Etcher on Windows using Chocolatey or winget.
404
- *
405
- * Prefers winget if available, falls back to Chocolatey.
406
- *
407
- * Prerequisites:
408
- * - Windows 10 or Windows 11 (64-bit)
409
- * - Chocolatey or winget package manager
410
- * - Administrator privileges
411
- *
412
- * @returns {Promise<void>}
413
- */
414
- async function install_windows() {
415
- // Check if already installed (idempotency check)
416
- const alreadyInstalled = await isInstalledOnWindows();
417
- if (alreadyInstalled) {
418
- console.log('Balena Etcher is already installed.');
419
- return;
420
- }
421
-
422
- // Try winget first (preferred on modern Windows)
423
- if (winget.isInstalled()) {
424
- console.log('Installing Balena Etcher via winget...');
425
-
426
- const result = await winget.install('Balena.Etcher');
427
-
428
- if (result.success) {
429
- // Verify installation succeeded
430
- const verifyInstalled = await isInstalledOnWindows();
431
- if (verifyInstalled) {
432
- console.log('Balena Etcher installed successfully.');
433
- console.log('Location: C:\\Program Files\\balenaEtcher\\balenaEtcher.exe');
434
- return;
435
- }
436
- }
437
-
438
- // If winget failed, fall through to try Chocolatey
439
- console.log('winget installation was not successful, trying Chocolatey...');
440
- }
441
-
442
- // Fall back to Chocolatey
443
- if (choco.isInstalled()) {
444
- console.log('Installing Balena Etcher via Chocolatey...');
445
-
446
- // Chocolatey package name is 'etcher'
447
- const result = await choco.install('etcher');
448
-
449
- if (!result.success) {
450
- console.error('Failed to install Balena Etcher:', result.output);
451
- return;
452
- }
453
-
454
- // Verify installation succeeded
455
- const verifyInstalled = await isInstalledOnWindows();
456
- if (verifyInstalled) {
457
- console.log('Balena Etcher installed successfully.');
458
- console.log('Location: C:\\Program Files\\balenaEtcher\\balenaEtcher.exe');
459
- } else {
460
- console.error('Installation completed but Balena Etcher was not found.');
461
- }
462
- return;
463
- }
464
-
465
- // Neither package manager is available
466
- console.log('Neither winget nor Chocolatey is installed.');
467
- console.log('Please install one of them first:');
468
- console.log('');
469
- console.log('For Chocolatey (PowerShell as Administrator):');
470
- console.log(' 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\'))');
471
- }
472
-
473
- /**
474
- * Install Balena Etcher on Ubuntu running in WSL (Windows Subsystem for Linux).
475
- *
476
- * Uses the same installation method as Ubuntu, but notes that WSLg is required
477
- * for GUI support and that USB device access is limited in WSL.
478
- *
479
- * Prerequisites:
480
- * - WSL 2 with Ubuntu
481
- * - Windows 11 or Windows 10 with WSLg enabled
482
- * - sudo privileges
483
- *
484
- * @returns {Promise<void>}
485
- */
486
- async function install_ubuntu_wsl() {
487
- // Check architecture FIRST - Balena Etcher only provides AMD64 packages for Linux
488
- // This must be checked before attempting any installations
489
- const arch = os.getArch();
490
- if (arch !== 'x64') {
491
- console.log(`Balena Etcher does not provide official ${arch} packages for WSL.`);
492
- console.log('');
493
- console.log('Note: Official Balena Etcher releases only support x64 (AMD64) architecture.');
494
- console.log('For ARM64 WSL, consider installing Balena Etcher on Windows directly instead.');
495
- return;
496
- }
497
-
498
- // Check if already installed (idempotency check)
499
- const alreadyInstalled = await isInstalledOnDebian();
500
- if (alreadyInstalled) {
501
- console.log('Balena Etcher is already installed.');
502
- return;
503
- }
504
-
505
- // WSL-specific note about USB limitations
506
- console.log('Note: Balena Etcher in WSL has limited USB device access.');
507
- console.log('For full USB support, consider installing on Windows directly.');
508
- console.log('');
509
-
510
- // Ensure wget is available for downloading
511
- if (!shell.commandExists('wget')) {
512
- console.log('Installing wget (required for download)...');
513
- // Update apt cache first for WSL
514
- await shell.exec('sudo DEBIAN_FRONTEND=noninteractive apt-get update -y');
515
- const wgetResult = await shell.exec('sudo DEBIAN_FRONTEND=noninteractive apt-get install -y wget');
516
- if (wgetResult.code !== 0) {
517
- console.error('Failed to install wget:', wgetResult.stderr);
518
- return;
519
- }
520
- }
521
-
522
- console.log('Downloading Balena Etcher .deb package...');
523
-
524
- // Download the .deb package to /tmp
525
- const downloadResult = await shell.exec(
526
- `wget -q -O /tmp/balena-etcher.deb "${DOWNLOAD_URLS.deb}"`
527
- );
528
-
529
- if (downloadResult.code !== 0) {
530
- console.error('Failed to download Balena Etcher:', downloadResult.stderr);
531
- return;
532
- }
533
-
534
- console.log('Installing Balena Etcher...');
535
-
536
- // Update package list first (important for fresh WSL instances)
537
- await shell.exec('sudo DEBIAN_FRONTEND=noninteractive apt-get update -y');
538
-
539
- // Install the .deb package using apt-get
540
- const installResult = await shell.exec(
541
- 'sudo DEBIAN_FRONTEND=noninteractive apt-get install -y /tmp/balena-etcher.deb'
542
- );
543
-
544
- // Clean up the downloaded file regardless of installation outcome
545
- await shell.exec('rm -f /tmp/balena-etcher.deb');
546
-
547
- if (installResult.code !== 0) {
548
- console.error('Failed to install Balena Etcher:', installResult.stderr);
549
- // Attempt to fix broken dependencies
550
- console.log('Attempting to fix broken dependencies...');
551
- await shell.exec('sudo DEBIAN_FRONTEND=noninteractive apt-get install -f -y');
552
- return;
553
- }
554
-
555
- // Verify installation succeeded
556
- const verifyInstalled = await isInstalledOnDebian();
557
- if (verifyInstalled) {
558
- console.log('Balena Etcher installed successfully.');
559
- console.log('Launch with: balena-etcher');
560
- console.log('');
561
- console.log('Note: Requires WSLg for GUI support. If you encounter display errors:');
562
- console.log(' 1. Ensure you are using WSL 2');
563
- console.log(' 2. Run: wsl --update (in PowerShell)');
564
- console.log(' 3. Restart WSL: wsl --shutdown && wsl');
565
- } else {
566
- console.error('Installation completed but Balena Etcher package was not found.');
567
- }
568
- }
569
-
570
- /**
571
- * Install Balena Etcher from Git Bash on Windows.
572
- *
573
- * Git Bash runs on Windows, so this function delegates to the Windows
574
- * installation method using Chocolatey.
575
- *
576
- * Prerequisites:
577
- * - Git Bash installed (comes with Git for Windows)
578
- * - Chocolatey installed on Windows
579
- * - Administrator privileges
580
- *
581
- * @returns {Promise<void>}
582
- */
583
- async function install_gitbash() {
584
- // Git Bash runs on Windows and can access Windows package managers
585
- // Delegate to Windows installation
586
- console.log('Installing Balena Etcher for Windows from Git Bash...');
587
- await install_windows();
588
- }
589
-
590
- /**
591
- * Check if Balena Etcher is installed on the current platform.
592
- *
593
- * Uses platform-appropriate verification:
594
- * - macOS: Checks for application bundle in /Applications
595
- * - Ubuntu/Debian/WSL: Checks dpkg package database
596
- * - Raspberry Pi OS: Checks for balena-etcher-electron command
597
- * - Amazon Linux/RHEL/Fedora: Checks rpm package database
598
- * - Windows: Checks for executable in Program Files
599
- *
600
- * @returns {Promise<boolean>} True if Balena Etcher is installed
601
- */
602
- async function isInstalled() {
603
- const platform = os.detect();
604
-
605
- const checks = {
606
- 'macos': isInstalledOnMacOS,
607
- 'ubuntu': isInstalledOnDebian,
608
- 'debian': isInstalledOnDebian,
609
- 'wsl': isInstalledOnDebian,
610
- 'raspbian': isInstalledOnRaspbian,
611
- 'amazon_linux': isInstalledOnRPM,
612
- 'fedora': isInstalledOnRPM,
613
- 'rhel': isInstalledOnRPM,
614
- 'windows': isInstalledOnWindows,
615
- 'gitbash': isInstalledOnWindows,
616
- };
617
-
618
- const checker = checks[platform.type];
619
- if (!checker) {
620
- return false;
621
- }
622
-
623
- // Handle both sync and async checkers
624
- const result = checker();
625
- return result instanceof Promise ? await result : result;
626
- }
627
-
628
- /**
629
- * Check if this installer is supported on the current platform.
630
- *
631
- * Balena Etcher can be installed on all supported platforms:
632
- * - macOS (via Homebrew cask)
633
- * - Ubuntu/Debian (via direct .deb download)
634
- * - Raspberry Pi OS (via Pi-Apps, 64-bit only)
635
- * - Amazon Linux/RHEL/Fedora (via direct .rpm download)
636
- * - Windows (via Chocolatey or winget)
637
- * - WSL (via direct .deb download)
638
- * - Git Bash (via Windows Chocolatey)
639
- *
640
- * @returns {boolean} True if installation is supported on this platform
641
- */
642
- function isEligible() {
643
- const platform = os.detect();
644
- const supportedPlatforms = ['macos', 'ubuntu', 'debian', 'wsl', 'raspbian', 'amazon_linux', 'fedora', 'rhel', 'windows', 'gitbash'];
645
- if (!supportedPlatforms.includes(platform.type)) {
646
- return false;
647
- }
648
- if (REQUIRES_DESKTOP && !os.isDesktopAvailable()) {
649
- return false;
650
- }
651
- return true;
652
- }
653
-
654
- /**
655
- * Main installation entry point - detects platform and runs appropriate installer.
656
- *
657
- * This function automatically determines the current operating system and
658
- * invokes the correct platform-specific installation function.
659
- *
660
- * @returns {Promise<void>}
661
- */
662
- async function install() {
663
- const platform = os.detect();
664
-
665
- // Map platform types to their respective installer functions
666
- const installers = {
667
- 'macos': install_macos,
668
- 'ubuntu': install_ubuntu,
669
- 'debian': install_ubuntu,
670
- 'wsl': install_ubuntu_wsl,
671
- 'raspbian': install_raspbian,
672
- 'amazon_linux': install_amazon_linux,
673
- 'fedora': install_amazon_linux,
674
- 'rhel': install_amazon_linux,
675
- 'windows': install_windows,
676
- 'gitbash': install_gitbash
677
- };
678
-
679
- const installer = installers[platform.type];
680
-
681
- // Handle unsupported platforms gracefully (no errors, no alternatives)
682
- if (!installer) {
683
- console.log(`Balena Etcher is not available for ${platform.type}.`);
684
- return;
685
- }
686
-
687
- await installer();
688
- }
689
-
690
- module.exports = {
691
- REQUIRES_DESKTOP,
692
- install,
693
- isEligible,
694
- isInstalled,
695
- install_macos,
696
- install_ubuntu,
697
- install_ubuntu_wsl,
698
- install_raspbian,
699
- install_amazon_linux,
700
- install_windows,
701
- install_gitbash
702
- };
703
-
704
- // Allow direct execution of this script
705
- if (require.main === module) {
706
- install().catch(err => {
707
- console.error(err.message);
708
- process.exit(1);
709
- });
710
- }