@fredlackey/devutils 0.0.18 → 0.1.0

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 (447) hide show
  1. package/README.md +214 -141
  2. package/package.json +8 -83
  3. package/src/api/loader.js +229 -0
  4. package/src/api/registry.json +62 -0
  5. package/src/cli.js +293 -60
  6. package/src/commands/ai/index.js +16 -0
  7. package/src/commands/ai/launch.js +112 -0
  8. package/src/commands/ai/list.js +54 -0
  9. package/src/commands/ai/resume.js +70 -0
  10. package/src/commands/ai/sessions.js +121 -0
  11. package/src/commands/ai/set.js +131 -0
  12. package/src/commands/ai/show.js +74 -0
  13. package/src/commands/ai/tools.js +46 -0
  14. package/src/commands/alias/add.js +93 -0
  15. package/src/commands/alias/helpers.js +107 -0
  16. package/src/commands/alias/index.js +14 -0
  17. package/src/commands/alias/list.js +55 -0
  18. package/src/commands/alias/remove.js +62 -0
  19. package/src/commands/alias/sync.js +109 -0
  20. package/src/commands/api/disable.js +73 -0
  21. package/src/commands/api/enable.js +148 -0
  22. package/src/commands/api/index.js +15 -0
  23. package/src/commands/api/list.js +66 -0
  24. package/src/commands/api/update.js +87 -0
  25. package/src/commands/auth/index.js +15 -0
  26. package/src/commands/auth/list.js +49 -0
  27. package/src/commands/auth/login.js +384 -0
  28. package/src/commands/auth/logout.js +111 -0
  29. package/src/commands/auth/refresh.js +184 -0
  30. package/src/commands/auth/services.js +169 -0
  31. package/src/commands/auth/status.js +104 -0
  32. package/src/commands/config/export.js +224 -0
  33. package/src/commands/config/get.js +52 -0
  34. package/src/commands/config/import.js +308 -0
  35. package/src/commands/config/index.js +17 -0
  36. package/src/commands/config/init.js +143 -0
  37. package/src/commands/config/reset.js +57 -0
  38. package/src/commands/config/set.js +93 -0
  39. package/src/commands/config/show.js +35 -0
  40. package/src/commands/help.js +338 -0
  41. package/src/commands/identity/add.js +133 -0
  42. package/src/commands/identity/index.js +17 -0
  43. package/src/commands/identity/link.js +76 -0
  44. package/src/commands/identity/list.js +48 -0
  45. package/src/commands/identity/remove.js +72 -0
  46. package/src/commands/identity/show.js +65 -0
  47. package/src/commands/identity/sync.js +172 -0
  48. package/src/commands/identity/unlink.js +57 -0
  49. package/src/commands/ignore/add.js +165 -0
  50. package/src/commands/ignore/index.js +14 -0
  51. package/src/commands/ignore/list.js +89 -0
  52. package/src/commands/ignore/markers.js +43 -0
  53. package/src/commands/ignore/remove.js +164 -0
  54. package/src/commands/ignore/show.js +169 -0
  55. package/src/commands/machine/detect.js +122 -0
  56. package/src/commands/machine/index.js +14 -0
  57. package/src/commands/machine/list.js +74 -0
  58. package/src/commands/machine/set.js +106 -0
  59. package/src/commands/machine/show.js +35 -0
  60. package/src/commands/schema.js +152 -0
  61. package/src/commands/search/collections.js +134 -0
  62. package/src/commands/search/get.js +71 -0
  63. package/src/commands/search/index-cmd.js +54 -0
  64. package/src/commands/search/index.js +21 -0
  65. package/src/commands/search/keyword.js +60 -0
  66. package/src/commands/search/qmd.js +70 -0
  67. package/src/commands/search/query.js +64 -0
  68. package/src/commands/search/semantic.js +62 -0
  69. package/src/commands/search/status.js +46 -0
  70. package/src/commands/status.js +224 -171
  71. package/src/commands/tools/check.js +79 -0
  72. package/src/commands/tools/index.js +14 -0
  73. package/src/commands/tools/install.js +110 -0
  74. package/src/commands/tools/list.js +91 -0
  75. package/src/commands/tools/search.js +60 -0
  76. package/src/commands/update.js +83 -112
  77. package/src/commands/util/add.js +151 -0
  78. package/src/commands/util/index.js +15 -0
  79. package/src/commands/util/list.js +97 -0
  80. package/src/commands/util/remove.js +76 -0
  81. package/src/commands/util/run.js +79 -0
  82. package/src/commands/util/show.js +67 -0
  83. package/src/commands/version.js +21 -88
  84. package/src/installers/_template.js +104 -0
  85. package/src/installers/git.js +150 -0
  86. package/src/installers/homebrew.js +190 -0
  87. package/src/installers/node.js +223 -0
  88. package/src/installers/registry.json +29 -0
  89. package/src/lib/config.js +125 -0
  90. package/src/lib/detect.js +74 -0
  91. package/src/lib/errors.js +114 -0
  92. package/src/lib/github.js +315 -0
  93. package/src/lib/installer.js +225 -0
  94. package/src/lib/output.js +239 -0
  95. package/src/lib/platform.js +112 -0
  96. package/src/lib/platforms/amazon-linux.js +41 -0
  97. package/src/lib/platforms/gitbash.js +46 -0
  98. package/src/lib/platforms/macos.js +45 -0
  99. package/src/lib/platforms/raspbian.js +41 -0
  100. package/src/lib/platforms/ubuntu.js +39 -0
  101. package/src/lib/platforms/windows.js +45 -0
  102. package/src/lib/prompt.js +161 -0
  103. package/src/lib/schema.js +211 -0
  104. package/src/lib/shell.js +75 -0
  105. package/src/patterns/gitignore/claude-code.txt +25 -0
  106. package/src/patterns/gitignore/docker.txt +15 -0
  107. package/src/patterns/gitignore/go.txt +24 -0
  108. package/src/patterns/gitignore/java.txt +38 -0
  109. package/src/patterns/gitignore/jetbrains.txt +26 -0
  110. package/src/patterns/gitignore/linux.txt +18 -0
  111. package/src/patterns/gitignore/macos.txt +27 -0
  112. package/src/patterns/gitignore/node.txt +51 -0
  113. package/src/patterns/gitignore/python.txt +55 -0
  114. package/src/patterns/gitignore/rust.txt +14 -0
  115. package/src/patterns/gitignore/terraform.txt +30 -0
  116. package/src/patterns/gitignore/vscode.txt +15 -0
  117. package/src/patterns/gitignore/windows.txt +25 -0
  118. package/src/utils/clone/index.js +165 -0
  119. package/src/utils/git-push/index.js +230 -0
  120. package/src/utils/git-status/index.js +116 -0
  121. package/src/utils/git-status/unix.sh +75 -0
  122. package/src/utils/registry.json +41 -0
  123. package/bin/dev.js +0 -16
  124. package/files/README.md +0 -0
  125. package/files/claude/.claude/commands/setup-context.md +0 -3
  126. package/files/monorepos/_archive/README.md +0 -36
  127. package/files/monorepos/_legacy/README.md +0 -36
  128. package/files/monorepos/ai-docs/README.md +0 -33
  129. package/files/monorepos/apps/README.md +0 -24
  130. package/files/monorepos/docs/README.md +0 -40
  131. package/files/monorepos/packages/README.md +0 -25
  132. package/files/monorepos/research/README.md +0 -29
  133. package/files/monorepos/scripts/README.md +0 -24
  134. package/src/commands/README.md +0 -41
  135. package/src/commands/configure.js +0 -199
  136. package/src/commands/identity.js +0 -1630
  137. package/src/commands/ignore.js +0 -247
  138. package/src/commands/install.js +0 -526
  139. package/src/commands/setup.js +0 -246
  140. package/src/completion.js +0 -284
  141. package/src/constants.js +0 -45
  142. package/src/ignore/claude-code.txt +0 -10
  143. package/src/ignore/docker.txt +0 -18
  144. package/src/ignore/linux.txt +0 -23
  145. package/src/ignore/macos.txt +0 -36
  146. package/src/ignore/node.txt +0 -55
  147. package/src/ignore/terraform.txt +0 -37
  148. package/src/ignore/vscode.txt +0 -18
  149. package/src/ignore/windows.txt +0 -35
  150. package/src/index.js +0 -0
  151. package/src/installs/README.md +0 -399
  152. package/src/installs/adobe-creative-cloud.js +0 -546
  153. package/src/installs/adobe-creative-cloud.md +0 -605
  154. package/src/installs/appcleaner.js +0 -321
  155. package/src/installs/appcleaner.md +0 -699
  156. package/src/installs/apt-transport-https.js +0 -390
  157. package/src/installs/apt-transport-https.md +0 -678
  158. package/src/installs/atomicparsley.js +0 -642
  159. package/src/installs/atomicparsley.md +0 -795
  160. package/src/installs/aws-cli.js +0 -797
  161. package/src/installs/aws-cli.md +0 -727
  162. package/src/installs/balena-etcher.js +0 -710
  163. package/src/installs/balena-etcher.md +0 -761
  164. package/src/installs/bambu-studio.js +0 -1143
  165. package/src/installs/bambu-studio.md +0 -780
  166. package/src/installs/bash-completion.js +0 -575
  167. package/src/installs/bash-completion.md +0 -833
  168. package/src/installs/bash.js +0 -417
  169. package/src/installs/bash.md +0 -993
  170. package/src/installs/beyond-compare.js +0 -603
  171. package/src/installs/beyond-compare.md +0 -813
  172. package/src/installs/brave-browser.js +0 -968
  173. package/src/installs/brave-browser.md +0 -650
  174. package/src/installs/build-essential.js +0 -529
  175. package/src/installs/build-essential.md +0 -977
  176. package/src/installs/ca-certificates.js +0 -618
  177. package/src/installs/ca-certificates.md +0 -937
  178. package/src/installs/caffeine.js +0 -508
  179. package/src/installs/caffeine.md +0 -839
  180. package/src/installs/camtasia.js +0 -596
  181. package/src/installs/camtasia.md +0 -762
  182. package/src/installs/chatgpt.js +0 -476
  183. package/src/installs/chatgpt.md +0 -814
  184. package/src/installs/chocolatey.js +0 -456
  185. package/src/installs/chocolatey.md +0 -661
  186. package/src/installs/chrome-canary.js +0 -419
  187. package/src/installs/chrome-canary.md +0 -641
  188. package/src/installs/chromium.js +0 -667
  189. package/src/installs/chromium.md +0 -838
  190. package/src/installs/claude-code.js +0 -576
  191. package/src/installs/claude-code.md +0 -1173
  192. package/src/installs/cloudflare-warp.js +0 -900
  193. package/src/installs/cloudflare-warp.md +0 -1047
  194. package/src/installs/comet-browser.js +0 -588
  195. package/src/installs/comet-browser.md +0 -731
  196. package/src/installs/curl.js +0 -379
  197. package/src/installs/curl.md +0 -714
  198. package/src/installs/cursor.js +0 -579
  199. package/src/installs/cursor.md +0 -970
  200. package/src/installs/dbeaver.js +0 -924
  201. package/src/installs/dbeaver.md +0 -939
  202. package/src/installs/dbschema.js +0 -692
  203. package/src/installs/dbschema.md +0 -925
  204. package/src/installs/dependencies.md +0 -453
  205. package/src/installs/development-tools.js +0 -600
  206. package/src/installs/development-tools.md +0 -977
  207. package/src/installs/docker.js +0 -1029
  208. package/src/installs/docker.md +0 -1109
  209. package/src/installs/drawio.js +0 -1019
  210. package/src/installs/drawio.md +0 -795
  211. package/src/installs/elmedia-player.js +0 -347
  212. package/src/installs/elmedia-player.md +0 -556
  213. package/src/installs/ffmpeg.js +0 -889
  214. package/src/installs/ffmpeg.md +0 -852
  215. package/src/installs/file.js +0 -464
  216. package/src/installs/file.md +0 -987
  217. package/src/installs/gemini-cli.js +0 -811
  218. package/src/installs/gemini-cli.md +0 -1153
  219. package/src/installs/git.js +0 -400
  220. package/src/installs/git.md +0 -907
  221. package/src/installs/gitego.js +0 -949
  222. package/src/installs/gitego.md +0 -1172
  223. package/src/installs/go.js +0 -931
  224. package/src/installs/go.md +0 -958
  225. package/src/installs/google-antigravity.js +0 -913
  226. package/src/installs/google-antigravity.md +0 -1075
  227. package/src/installs/google-chrome.js +0 -833
  228. package/src/installs/google-chrome.md +0 -862
  229. package/src/installs/gpg.js +0 -480
  230. package/src/installs/gpg.md +0 -1056
  231. package/src/installs/homebrew.js +0 -1028
  232. package/src/installs/homebrew.md +0 -988
  233. package/src/installs/imageoptim.js +0 -968
  234. package/src/installs/imageoptim.md +0 -1119
  235. package/src/installs/installers.json +0 -4032
  236. package/src/installs/installers.json.tmp +0 -3953
  237. package/src/installs/jq.js +0 -400
  238. package/src/installs/jq.md +0 -809
  239. package/src/installs/keyboard-maestro.js +0 -719
  240. package/src/installs/keyboard-maestro.md +0 -825
  241. package/src/installs/kiro.js +0 -864
  242. package/src/installs/kiro.md +0 -1015
  243. package/src/installs/latex.js +0 -789
  244. package/src/installs/latex.md +0 -1095
  245. package/src/installs/lftp.js +0 -356
  246. package/src/installs/lftp.md +0 -907
  247. package/src/installs/lsb-release.js +0 -346
  248. package/src/installs/lsb-release.md +0 -814
  249. package/src/installs/messenger.js +0 -847
  250. package/src/installs/messenger.md +0 -900
  251. package/src/installs/microsoft-office.js +0 -568
  252. package/src/installs/microsoft-office.md +0 -760
  253. package/src/installs/microsoft-teams.js +0 -801
  254. package/src/installs/microsoft-teams.md +0 -886
  255. package/src/installs/moom.js +0 -326
  256. package/src/installs/moom.md +0 -570
  257. package/src/installs/node.js +0 -904
  258. package/src/installs/node.md +0 -1153
  259. package/src/installs/nordpass.js +0 -716
  260. package/src/installs/nordpass.md +0 -921
  261. package/src/installs/nordvpn.js +0 -892
  262. package/src/installs/nordvpn.md +0 -1052
  263. package/src/installs/nvm.js +0 -995
  264. package/src/installs/nvm.md +0 -1057
  265. package/src/installs/ohmyzsh.js +0 -529
  266. package/src/installs/ohmyzsh.md +0 -1094
  267. package/src/installs/openssh.js +0 -804
  268. package/src/installs/openssh.md +0 -1056
  269. package/src/installs/pandoc.js +0 -662
  270. package/src/installs/pandoc.md +0 -1036
  271. package/src/installs/parallels-desktop.js +0 -431
  272. package/src/installs/parallels-desktop.md +0 -446
  273. package/src/installs/pinentry.js +0 -510
  274. package/src/installs/pinentry.md +0 -1142
  275. package/src/installs/pngyu.js +0 -869
  276. package/src/installs/pngyu.md +0 -896
  277. package/src/installs/postman.js +0 -799
  278. package/src/installs/postman.md +0 -940
  279. package/src/installs/procps.js +0 -425
  280. package/src/installs/procps.md +0 -851
  281. package/src/installs/safari-tech-preview.js +0 -374
  282. package/src/installs/safari-tech-preview.md +0 -533
  283. package/src/installs/sfnt2woff.js +0 -658
  284. package/src/installs/sfnt2woff.md +0 -795
  285. package/src/installs/shellcheck.js +0 -481
  286. package/src/installs/shellcheck.md +0 -1005
  287. package/src/installs/slack.js +0 -741
  288. package/src/installs/slack.md +0 -865
  289. package/src/installs/snagit.js +0 -585
  290. package/src/installs/snagit.md +0 -844
  291. package/src/installs/software-properties-common.js +0 -372
  292. package/src/installs/software-properties-common.md +0 -805
  293. package/src/installs/spotify.js +0 -877
  294. package/src/installs/spotify.md +0 -901
  295. package/src/installs/studio-3t.js +0 -823
  296. package/src/installs/studio-3t.md +0 -918
  297. package/src/installs/sublime-text.js +0 -804
  298. package/src/installs/sublime-text.md +0 -914
  299. package/src/installs/superwhisper.js +0 -706
  300. package/src/installs/superwhisper.md +0 -630
  301. package/src/installs/tailscale.js +0 -745
  302. package/src/installs/tailscale.md +0 -1100
  303. package/src/installs/tar.js +0 -389
  304. package/src/installs/tar.md +0 -946
  305. package/src/installs/termius.js +0 -798
  306. package/src/installs/termius.md +0 -844
  307. package/src/installs/terraform.js +0 -779
  308. package/src/installs/terraform.md +0 -899
  309. package/src/installs/tfenv.js +0 -778
  310. package/src/installs/tfenv.md +0 -1091
  311. package/src/installs/tidal.js +0 -771
  312. package/src/installs/tidal.md +0 -864
  313. package/src/installs/tmux.js +0 -346
  314. package/src/installs/tmux.md +0 -1030
  315. package/src/installs/tree.js +0 -411
  316. package/src/installs/tree.md +0 -833
  317. package/src/installs/unzip.js +0 -460
  318. package/src/installs/unzip.md +0 -879
  319. package/src/installs/vim.js +0 -421
  320. package/src/installs/vim.md +0 -1040
  321. package/src/installs/vlc.js +0 -821
  322. package/src/installs/vlc.md +0 -927
  323. package/src/installs/vscode.js +0 -843
  324. package/src/installs/vscode.md +0 -1002
  325. package/src/installs/wget.js +0 -420
  326. package/src/installs/wget.md +0 -791
  327. package/src/installs/whatsapp.js +0 -729
  328. package/src/installs/whatsapp.md +0 -854
  329. package/src/installs/winpty.js +0 -352
  330. package/src/installs/winpty.md +0 -620
  331. package/src/installs/woff2.js +0 -553
  332. package/src/installs/woff2.md +0 -977
  333. package/src/installs/wsl.js +0 -572
  334. package/src/installs/wsl.md +0 -699
  335. package/src/installs/xcode-clt.js +0 -520
  336. package/src/installs/xcode-clt.md +0 -351
  337. package/src/installs/xcode.js +0 -560
  338. package/src/installs/xcode.md +0 -573
  339. package/src/installs/yarn.js +0 -824
  340. package/src/installs/yarn.md +0 -1074
  341. package/src/installs/yq.js +0 -654
  342. package/src/installs/yq.md +0 -944
  343. package/src/installs/yt-dlp.js +0 -701
  344. package/src/installs/yt-dlp.md +0 -946
  345. package/src/installs/yum-utils.js +0 -297
  346. package/src/installs/yum-utils.md +0 -648
  347. package/src/installs/zoom.js +0 -759
  348. package/src/installs/zoom.md +0 -884
  349. package/src/installs/zsh.js +0 -455
  350. package/src/installs/zsh.md +0 -1008
  351. package/src/scripts/README.md +0 -617
  352. package/src/scripts/STATUS.md +0 -208
  353. package/src/scripts/afk.js +0 -411
  354. package/src/scripts/backup-all.js +0 -746
  355. package/src/scripts/backup-source.js +0 -727
  356. package/src/scripts/brewd.js +0 -389
  357. package/src/scripts/brewi.js +0 -520
  358. package/src/scripts/brewr.js +0 -527
  359. package/src/scripts/brews.js +0 -477
  360. package/src/scripts/brewu.js +0 -504
  361. package/src/scripts/c.js +0 -201
  362. package/src/scripts/ccurl.js +0 -341
  363. package/src/scripts/certbot-crontab-init.js +0 -504
  364. package/src/scripts/certbot-init.js +0 -657
  365. package/src/scripts/ch.js +0 -355
  366. package/src/scripts/claude-danger.js +0 -268
  367. package/src/scripts/clean-dev.js +0 -435
  368. package/src/scripts/clear-dns-cache.js +0 -541
  369. package/src/scripts/clone.js +0 -435
  370. package/src/scripts/code-all.js +0 -437
  371. package/src/scripts/count-files.js +0 -211
  372. package/src/scripts/count-folders.js +0 -211
  373. package/src/scripts/count.js +0 -264
  374. package/src/scripts/d.js +0 -219
  375. package/src/scripts/datauri.js +0 -389
  376. package/src/scripts/delete-files.js +0 -380
  377. package/src/scripts/docker-clean.js +0 -426
  378. package/src/scripts/dp.js +0 -442
  379. package/src/scripts/e.js +0 -390
  380. package/src/scripts/empty-trash.js +0 -513
  381. package/src/scripts/evm.js +0 -444
  382. package/src/scripts/fetch-github-repos.js +0 -456
  383. package/src/scripts/get-channel.js +0 -345
  384. package/src/scripts/get-course.js +0 -399
  385. package/src/scripts/get-dependencies.js +0 -306
  386. package/src/scripts/get-folder.js +0 -799
  387. package/src/scripts/get-tunes.js +0 -426
  388. package/src/scripts/get-video.js +0 -367
  389. package/src/scripts/git-backup.js +0 -577
  390. package/src/scripts/git-clone.js +0 -493
  391. package/src/scripts/git-pup.js +0 -319
  392. package/src/scripts/git-push.js +0 -396
  393. package/src/scripts/h.js +0 -622
  394. package/src/scripts/hide-desktop-icons.js +0 -499
  395. package/src/scripts/hide-hidden-files.js +0 -538
  396. package/src/scripts/install-dependencies-from.js +0 -456
  397. package/src/scripts/ips.js +0 -663
  398. package/src/scripts/iso.js +0 -370
  399. package/src/scripts/killni.js +0 -577
  400. package/src/scripts/ll.js +0 -467
  401. package/src/scripts/local-ip.js +0 -325
  402. package/src/scripts/m.js +0 -524
  403. package/src/scripts/map.js +0 -309
  404. package/src/scripts/mkd.js +0 -351
  405. package/src/scripts/ncu-update-all.js +0 -457
  406. package/src/scripts/nginx-init.js +0 -718
  407. package/src/scripts/npmi.js +0 -382
  408. package/src/scripts/o.js +0 -511
  409. package/src/scripts/org-by-date.js +0 -338
  410. package/src/scripts/p.js +0 -224
  411. package/src/scripts/packages.js +0 -330
  412. package/src/scripts/path.js +0 -225
  413. package/src/scripts/ports.js +0 -597
  414. package/src/scripts/q.js +0 -305
  415. package/src/scripts/refresh-files.js +0 -394
  416. package/src/scripts/remove-smaller-files.js +0 -516
  417. package/src/scripts/rename-files-with-date.js +0 -533
  418. package/src/scripts/resize-image.js +0 -539
  419. package/src/scripts/rm-safe.js +0 -669
  420. package/src/scripts/s.js +0 -540
  421. package/src/scripts/set-git-public.js +0 -365
  422. package/src/scripts/show-desktop-icons.js +0 -475
  423. package/src/scripts/show-hidden-files.js +0 -472
  424. package/src/scripts/tpa.js +0 -280
  425. package/src/scripts/tpo.js +0 -280
  426. package/src/scripts/u.js +0 -505
  427. package/src/scripts/vpush.js +0 -437
  428. package/src/scripts/y.js +0 -283
  429. package/src/utils/README.md +0 -95
  430. package/src/utils/common/apps.js +0 -143
  431. package/src/utils/common/display.js +0 -157
  432. package/src/utils/common/network.js +0 -185
  433. package/src/utils/common/os.js +0 -294
  434. package/src/utils/common/package-manager.js +0 -301
  435. package/src/utils/common/privileges.js +0 -138
  436. package/src/utils/common/shell.js +0 -261
  437. package/src/utils/macos/apps.js +0 -228
  438. package/src/utils/macos/brew.js +0 -315
  439. package/src/utils/ubuntu/apt.js +0 -307
  440. package/src/utils/ubuntu/desktop.js +0 -292
  441. package/src/utils/ubuntu/snap.js +0 -344
  442. package/src/utils/ubuntu/systemd.js +0 -286
  443. package/src/utils/windows/choco.js +0 -465
  444. package/src/utils/windows/env.js +0 -246
  445. package/src/utils/windows/registry.js +0 -269
  446. package/src/utils/windows/shell.js +0 -240
  447. package/src/utils/windows/winget.js +0 -489
@@ -1,771 +0,0 @@
1
- #!/usr/bin/env node
2
-
3
- /**
4
- * @fileoverview Install Tidal.
5
- * @module installs/tidal
6
- *
7
- * Tidal is a high-fidelity music streaming service that provides access to over
8
- * 100 million songs and 650,000+ music videos. Known for its lossless audio quality,
9
- * Tidal offers HiFi (lossless CD quality at 16-bit/44.1kHz) and HiFi Plus
10
- * (Master Quality Authenticated/MQA and HiRes FLAC up to 24-bit/192kHz) streaming tiers.
11
- *
12
- * This installer provides:
13
- * - Tidal Desktop App for macOS via Homebrew cask
14
- * - Tidal Desktop App for Windows via Chocolatey
15
- * - tidal-hifi (third-party client) for Ubuntu/Debian via Flatpak (x86_64 only)
16
- * - tidal-hifi for Amazon Linux/RHEL via Flatpak (x86_64 only)
17
- * - Instructions to launch Windows Tidal from WSL/Git Bash
18
- *
19
- * IMPORTANT PLATFORM NOTES:
20
- * - Raspberry Pi OS: Tidal does not provide native ARM packages, and tidal-hifi
21
- * is only available for x86_64 architecture. Raspberry Pi devices use ARM
22
- * processors, which are not supported. Users can use Tidal Connect via Docker.
23
- * - Linux: Tidal does not provide an official desktop application for Linux.
24
- * This installer uses tidal-hifi, an open-source Electron-based wrapper for
25
- * the Tidal web player with native desktop features.
26
- */
27
-
28
- const os = require('../utils/common/os');
29
- const shell = require('../utils/common/shell');
30
- const brew = require('../utils/macos/brew');
31
- const macosApps = require('../utils/macos/apps');
32
- const choco = require('../utils/windows/choco');
33
-
34
- /**
35
- * Indicates whether this installer requires a desktop environment.
36
- * Tidal is a GUI music streaming application and requires a display.
37
- * @type {boolean}
38
- */
39
- const REQUIRES_DESKTOP = true;
40
-
41
- /**
42
- * The Homebrew cask name for Tidal on macOS.
43
- * This installs the full desktop application to /Applications.
44
- */
45
- const HOMEBREW_CASK_NAME = 'tidal';
46
-
47
- /**
48
- * The Chocolatey package name for Tidal on Windows.
49
- */
50
- const CHOCO_PACKAGE_NAME = 'tidal';
51
-
52
- /**
53
- * The Flatpak application ID for tidal-hifi on Linux.
54
- * tidal-hifi is a third-party open-source client that wraps the Tidal web player
55
- * in an Electron shell with added features like media key support and MPRIS.
56
- */
57
- const FLATPAK_APP_ID = 'com.mastermindzh.tidal-hifi';
58
-
59
- /**
60
- * Check if Tidal Desktop application is installed on macOS.
61
- *
62
- * Looks for TIDAL.app in /Applications or ~/Applications using the
63
- * macosApps utility which handles common variations of app names.
64
- *
65
- * @returns {boolean} True if TIDAL.app exists, false otherwise
66
- */
67
- function isTidalInstalledMacOS() {
68
- return macosApps.isAppInstalled('TIDAL');
69
- }
70
-
71
- /**
72
- * Check if tidal-hifi is installed via Flatpak on Linux systems.
73
- *
74
- * Queries the Flatpak database to determine if the tidal-hifi application
75
- * is present in the system or user installation.
76
- *
77
- * @returns {Promise<boolean>} True if tidal-hifi is installed via Flatpak, false otherwise
78
- */
79
- async function isTidalHifiInstalledFlatpak() {
80
- const result = await shell.exec(`flatpak list | grep -i "${FLATPAK_APP_ID}"`);
81
- return result.code === 0 && result.stdout.includes(FLATPAK_APP_ID);
82
- }
83
-
84
- /**
85
- * Check if Flatpak is installed and available on the system.
86
- *
87
- * @returns {boolean} True if flatpak command exists in PATH, false otherwise
88
- */
89
- function isFlatpakInstalled() {
90
- return shell.commandExists('flatpak');
91
- }
92
-
93
- /**
94
- * Install Tidal Desktop on macOS using Homebrew cask.
95
- *
96
- * Prerequisites:
97
- * - macOS 12 (Monterey) or later
98
- * - Homebrew package manager installed
99
- * - At least 200 MB free disk space
100
- * - Apple Silicon (M1/M2/M3/M4) or Intel processor
101
- *
102
- * The installation uses the Homebrew cask 'tidal' which downloads and installs
103
- * the Tidal desktop application to /Applications/TIDAL.app.
104
- *
105
- * NOTE: After installation, Tidal must be launched manually. On first launch,
106
- * it will prompt you to sign in with your Tidal account credentials.
107
- *
108
- * @returns {Promise<void>}
109
- * @throws {Error} If Homebrew is not installed or installation fails
110
- */
111
- async function install_macos() {
112
- console.log('Checking if Tidal is already installed...');
113
-
114
- // Check if TIDAL.app already exists in Applications
115
- if (isTidalInstalledMacOS()) {
116
- console.log('Tidal is already installed, skipping installation.');
117
- return;
118
- }
119
-
120
- // Also check if the cask is installed via Homebrew
121
- const caskInstalled = await brew.isCaskInstalled(HOMEBREW_CASK_NAME);
122
- if (caskInstalled) {
123
- console.log('Tidal is already installed via Homebrew, skipping installation.');
124
- return;
125
- }
126
-
127
- // Verify Homebrew is available before attempting installation
128
- if (!brew.isInstalled()) {
129
- throw new Error(
130
- 'Homebrew is not installed. Please install Homebrew first using:\n' +
131
- ' dev install homebrew\n' +
132
- 'Then retry installing Tidal.'
133
- );
134
- }
135
-
136
- console.log('Installing Tidal via Homebrew...');
137
-
138
- // Install Tidal cask with quiet flag for cleaner output
139
- // The --quiet flag suppresses non-essential output for automation-friendly installation
140
- const result = await shell.exec('brew install --quiet --cask tidal');
141
-
142
- if (result.code !== 0) {
143
- throw new Error(
144
- `Failed to install Tidal via Homebrew.\n` +
145
- `Output: ${result.stderr || result.stdout}\n\n` +
146
- `Troubleshooting:\n` +
147
- ` 1. Run 'brew update && brew cleanup' and retry\n` +
148
- ` 2. Check if macOS version is 12 (Monterey) or later\n` +
149
- ` 3. Try manual installation: brew reinstall --cask tidal`
150
- );
151
- }
152
-
153
- // Verify installation succeeded by checking if app now exists
154
- if (!isTidalInstalledMacOS()) {
155
- throw new Error(
156
- 'Installation command completed but TIDAL.app was not found in Applications.\n\n' +
157
- 'Please try:\n' +
158
- ' 1. Check /Applications for TIDAL.app\n' +
159
- ' 2. Run: brew reinstall --cask tidal'
160
- );
161
- }
162
-
163
- console.log('Tidal installed successfully.');
164
- console.log('');
165
- console.log('To launch Tidal:');
166
- console.log(' - Open from Applications folder, or');
167
- console.log(' - Run: open -a TIDAL');
168
- console.log('');
169
- console.log('On first launch, you will be prompted to sign in with your');
170
- console.log('Tidal account credentials.');
171
- }
172
-
173
- /**
174
- * Install tidal-hifi on Ubuntu/Debian using Flatpak.
175
- *
176
- * PLATFORM NOTE: Tidal does not provide an official desktop application for Linux.
177
- * This function installs tidal-hifi, an open-source Electron-based application
178
- * that wraps the Tidal web player with native desktop features including:
179
- * - HiFi audio quality support via Widevine
180
- * - Media key integration
181
- * - MPRIS support for desktop audio controls
182
- * - Discord Rich Presence integration
183
- * - ListenBrainz scrobbling
184
- *
185
- * Prerequisites:
186
- * - Ubuntu 18.04 LTS or later, or Debian 10 (Buster) or later
187
- * - 64-bit x86_64 architecture (ARM is not supported)
188
- * - sudo privileges
189
- * - Flatpak installed
190
- * - At least 500 MB free disk space
191
- *
192
- * @returns {Promise<void>}
193
- * @throws {Error} If installation fails on supported architecture
194
- */
195
- async function install_ubuntu() {
196
- console.log('Checking if tidal-hifi is already installed...');
197
-
198
- // Check if tidal-hifi is already installed via Flatpak
199
- if (isFlatpakInstalled()) {
200
- const isInstalled = await isTidalHifiInstalledFlatpak();
201
- if (isInstalled) {
202
- console.log('tidal-hifi is already installed, skipping installation.');
203
- return;
204
- }
205
- }
206
-
207
- // Verify architecture - tidal-hifi Flatpak only supports x86_64
208
- // ARM systems should use the web player at https://listen.tidal.com
209
- const archResult = await shell.exec('uname -m');
210
- const architecture = archResult.stdout.trim();
211
- if (architecture !== 'x86_64') {
212
- console.log(`Tidal is not available for ${architecture} architecture.`);
213
- console.log('');
214
- console.log('tidal-hifi requires 64-bit x86_64 architecture.');
215
- console.log('You can use the Tidal web player at https://listen.tidal.com instead.');
216
- return;
217
- }
218
-
219
- console.log('');
220
- console.log('NOTE: Tidal does not provide an official desktop app for Linux.');
221
- console.log('Installing tidal-hifi - a third-party open-source client.');
222
- console.log('');
223
-
224
- // Step 1: Ensure Flatpak is installed
225
- if (!isFlatpakInstalled()) {
226
- console.log('Installing Flatpak...');
227
- const flatpakInstallResult = await shell.exec(
228
- 'sudo DEBIAN_FRONTEND=noninteractive apt-get update -y && ' +
229
- 'sudo DEBIAN_FRONTEND=noninteractive apt-get install -y flatpak'
230
- );
231
-
232
- if (flatpakInstallResult.code !== 0) {
233
- throw new Error(
234
- 'Failed to install Flatpak.\n' +
235
- `Output: ${flatpakInstallResult.stderr}\n\n` +
236
- 'Please try:\n' +
237
- ' sudo apt-get update && sudo apt-get install -y flatpak'
238
- );
239
- }
240
- }
241
-
242
- // Step 2: Add Flathub repository if not already added
243
- console.log('Adding Flathub repository...');
244
- const flathubResult = await shell.exec(
245
- 'flatpak remote-add --if-not-exists flathub https://dl.flathub.org/repo/flathub.flatpakrepo'
246
- );
247
-
248
- if (flathubResult.code !== 0) {
249
- throw new Error(
250
- 'Failed to add Flathub repository.\n' +
251
- `Output: ${flathubResult.stderr}\n\n` +
252
- 'Please try:\n' +
253
- ' flatpak remote-add --if-not-exists flathub https://dl.flathub.org/repo/flathub.flatpakrepo'
254
- );
255
- }
256
-
257
- // Step 3: Install tidal-hifi via Flatpak
258
- console.log('Installing tidal-hifi via Flatpak...');
259
- console.log('This may take a few minutes...');
260
-
261
- const installResult = await shell.exec(`flatpak install -y flathub ${FLATPAK_APP_ID}`);
262
-
263
- if (installResult.code !== 0) {
264
- throw new Error(
265
- 'Failed to install tidal-hifi via Flatpak.\n' +
266
- `Output: ${installResult.stderr || installResult.stdout}\n\n` +
267
- 'Troubleshooting:\n' +
268
- ' 1. Ensure Flatpak is properly installed\n' +
269
- ' 2. Log out and log back in if Flatpak was just installed\n' +
270
- ` 3. Try manual installation: flatpak install -y flathub ${FLATPAK_APP_ID}`
271
- );
272
- }
273
-
274
- // Verify installation succeeded
275
- const verifyInstalled = await isTidalHifiInstalledFlatpak();
276
- if (!verifyInstalled) {
277
- throw new Error(
278
- 'Installation command completed but tidal-hifi was not found.\n\n' +
279
- 'Please try:\n' +
280
- ' 1. Run: flatpak list | grep tidal\n' +
281
- ` 2. Retry: flatpak install -y flathub ${FLATPAK_APP_ID}`
282
- );
283
- }
284
-
285
- console.log('tidal-hifi installed successfully.');
286
- console.log('');
287
- console.log('To launch tidal-hifi:');
288
- console.log(` - Run: flatpak run ${FLATPAK_APP_ID} &`);
289
- console.log(' - Or find "TIDAL Hi-Fi" in your application menu');
290
- console.log('');
291
- console.log('On first launch, you will be prompted to sign in with your');
292
- console.log('Tidal account credentials.');
293
- console.log('');
294
- console.log('NOTE: You may need to log out and log back in for the');
295
- console.log('application to appear in your application menu.');
296
- }
297
-
298
- /**
299
- * Install Tidal on Raspberry Pi OS.
300
- *
301
- * PLATFORM LIMITATION: Tidal does not provide native ARM packages, and tidal-hifi
302
- * is only available for x86_64 architecture. Raspberry Pi devices use ARM
303
- * processors, which are not supported by the official Tidal client or tidal-hifi.
304
- *
305
- * This function gracefully informs the user that Tidal is not available for
306
- * Raspberry Pi and provides information about Tidal Connect as an alternative.
307
- *
308
- * @returns {Promise<void>}
309
- */
310
- async function install_raspbian() {
311
- console.log('Tidal is not available for Raspberry Pi OS.');
312
- console.log('');
313
- console.log('The Tidal desktop application and tidal-hifi require x86_64 architecture.');
314
- console.log('Raspberry Pi uses ARM processors which are not supported.');
315
- console.log('');
316
- console.log('Alternative: You can set up Tidal Connect using Docker to turn your');
317
- console.log('Raspberry Pi into a Tidal streaming endpoint. Control playback from');
318
- console.log('your phone, tablet, or computer, and audio plays through the Pi.');
319
- console.log('');
320
- console.log('For Tidal Connect setup instructions, see:');
321
- console.log(' https://github.com/GioF71/tidal-connect');
322
- return;
323
- }
324
-
325
- /**
326
- * Install tidal-hifi on Amazon Linux/RHEL using Flatpak.
327
- *
328
- * PLATFORM NOTE: Tidal does not provide an official desktop application for Linux.
329
- * This function installs tidal-hifi via Flatpak on RHEL-based distributions.
330
- *
331
- * Prerequisites:
332
- * - Amazon Linux 2023, Amazon Linux 2, RHEL 8/9, or Fedora (64-bit x86_64)
333
- * - sudo privileges
334
- * - Graphical desktop environment (required for tidal-hifi GUI)
335
- * - At least 500 MB free disk space
336
- *
337
- * IMPORTANT: Amazon Linux EC2 instances typically run headless (no GUI).
338
- * If you are running a headless server, use the Tidal web player at
339
- * https://listen.tidal.com instead.
340
- *
341
- * @returns {Promise<void>}
342
- * @throws {Error} If installation fails on supported architecture
343
- */
344
- async function install_amazon_linux() {
345
- console.log('Checking if tidal-hifi is already installed...');
346
-
347
- // Check if tidal-hifi is already installed via Flatpak
348
- if (isFlatpakInstalled()) {
349
- const isInstalled = await isTidalHifiInstalledFlatpak();
350
- if (isInstalled) {
351
- console.log('tidal-hifi is already installed, skipping installation.');
352
- return;
353
- }
354
- }
355
-
356
- // Verify architecture - tidal-hifi only supports x86_64
357
- const archResult = await shell.exec('uname -m');
358
- const architecture = archResult.stdout.trim();
359
- if (architecture !== 'x86_64') {
360
- console.log(`Tidal is not available for ${architecture} architecture.`);
361
- console.log('');
362
- console.log('tidal-hifi requires 64-bit x86_64 architecture.');
363
- console.log('You can use the Tidal web player at https://listen.tidal.com instead.');
364
- return;
365
- }
366
-
367
- // Detect package manager (dnf for AL2023/RHEL8+, yum for AL2)
368
- const hasDnf = shell.commandExists('dnf');
369
- const hasYum = shell.commandExists('yum');
370
- const packageManager = hasDnf ? 'dnf' : (hasYum ? 'yum' : null);
371
-
372
- if (!packageManager) {
373
- throw new Error(
374
- 'Neither dnf nor yum package manager found.\n' +
375
- 'This installer supports Amazon Linux 2023 (dnf) and Amazon Linux 2 (yum).'
376
- );
377
- }
378
-
379
- console.log(`Detected package manager: ${packageManager}`);
380
- console.log('');
381
- console.log('NOTE: Tidal does not provide an official desktop app for Linux.');
382
- console.log('Installing tidal-hifi - a third-party open-source client.');
383
- console.log('');
384
-
385
- // Step 1: Install Flatpak if not already installed
386
- if (!isFlatpakInstalled()) {
387
- console.log('Installing Flatpak...');
388
- const flatpakInstallResult = await shell.exec(`sudo ${packageManager} install -y flatpak`);
389
-
390
- if (flatpakInstallResult.code !== 0) {
391
- throw new Error(
392
- 'Failed to install Flatpak.\n' +
393
- `Output: ${flatpakInstallResult.stderr}\n\n` +
394
- 'Troubleshooting:\n' +
395
- ` 1. Try: sudo ${packageManager} install -y flatpak\n` +
396
- ' 2. Ensure EPEL repository is enabled for RHEL-based systems'
397
- );
398
- }
399
- }
400
-
401
- // Step 2: Add Flathub repository if not already added
402
- console.log('Adding Flathub repository...');
403
- const flathubResult = await shell.exec(
404
- 'flatpak remote-add --if-not-exists flathub https://dl.flathub.org/repo/flathub.flatpakrepo'
405
- );
406
-
407
- if (flathubResult.code !== 0) {
408
- throw new Error(
409
- 'Failed to add Flathub repository.\n' +
410
- `Output: ${flathubResult.stderr}\n\n` +
411
- 'Please try:\n' +
412
- ' flatpak remote-add --if-not-exists flathub https://dl.flathub.org/repo/flathub.flatpakrepo'
413
- );
414
- }
415
-
416
- // Step 3: Install tidal-hifi via Flatpak
417
- console.log('Installing tidal-hifi via Flatpak...');
418
- console.log('This may take a few minutes...');
419
-
420
- const installResult = await shell.exec(`flatpak install -y flathub ${FLATPAK_APP_ID}`);
421
-
422
- if (installResult.code !== 0) {
423
- throw new Error(
424
- 'Failed to install tidal-hifi via Flatpak.\n' +
425
- `Output: ${installResult.stderr || installResult.stdout}\n\n` +
426
- 'Troubleshooting:\n' +
427
- ' 1. You may need to log out and back in after installing Flatpak\n' +
428
- ` 2. Try manual installation: flatpak install -y flathub ${FLATPAK_APP_ID}`
429
- );
430
- }
431
-
432
- // Verify installation
433
- const verifyInstalled = await isTidalHifiInstalledFlatpak();
434
- if (!verifyInstalled) {
435
- // Flatpak might not be fully in PATH yet
436
- console.log('');
437
- console.log('tidal-hifi installation completed.');
438
- console.log('');
439
- console.log('IMPORTANT: You may need to log out and log back in for the');
440
- console.log('flatpak command to become available in your PATH.');
441
- console.log('');
442
- console.log('After logging back in:');
443
- console.log(` - Run: flatpak run ${FLATPAK_APP_ID} &`);
444
- console.log(' - Or find "TIDAL Hi-Fi" in your application menu');
445
- return;
446
- }
447
-
448
- console.log('tidal-hifi installed successfully.');
449
- console.log('');
450
- console.log('To launch tidal-hifi:');
451
- console.log(` - Run: flatpak run ${FLATPAK_APP_ID} &`);
452
- console.log(' - Or find "TIDAL Hi-Fi" in your application menu');
453
- console.log('');
454
- console.log('NOTE: tidal-hifi requires a graphical desktop environment.');
455
- console.log('If running on a headless server, use the web player at:');
456
- console.log(' https://listen.tidal.com');
457
- }
458
-
459
- /**
460
- * Install Tidal on Windows using Chocolatey.
461
- *
462
- * Prerequisites:
463
- * - Windows 10 version 1903 or later, or Windows 11 (64-bit)
464
- * - At least 250 MB free disk space
465
- * - Administrator PowerShell or Command Prompt
466
- * - Chocolatey package manager installed
467
- *
468
- * The installation uses Chocolatey's 'tidal' package which downloads and
469
- * installs the official Tidal desktop application.
470
- *
471
- * NOTE: After installation, Tidal can be launched from the Start Menu or
472
- * via the 'tidal:' protocol handler.
473
- *
474
- * @returns {Promise<void>}
475
- * @throws {Error} If Chocolatey is not installed or installation fails
476
- */
477
- async function install_windows() {
478
- console.log('Checking if Tidal is already installed...');
479
-
480
- // Check if Tidal is already installed via Chocolatey
481
- const isInstalled = await choco.isPackageInstalled(CHOCO_PACKAGE_NAME);
482
- if (isInstalled) {
483
- console.log('Tidal is already installed, skipping installation.');
484
- return;
485
- }
486
-
487
- // Verify Chocolatey is available before attempting installation
488
- if (!choco.isInstalled()) {
489
- throw new Error(
490
- 'Chocolatey is not installed. Please install Chocolatey first:\n\n' +
491
- 'Run the following in an Administrator PowerShell:\n' +
492
- ' Set-ExecutionPolicy Bypass -Scope Process -Force; ' +
493
- '[System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072; ' +
494
- 'iex ((New-Object System.Net.WebClient).DownloadString(\'https://community.chocolatey.org/install.ps1\'))\n\n' +
495
- 'Then retry installing Tidal.'
496
- );
497
- }
498
-
499
- console.log('Installing Tidal via Chocolatey...');
500
- console.log('This may take a few minutes...');
501
-
502
- // Install Tidal using Chocolatey
503
- // The -y flag automatically confirms all prompts
504
- const result = await choco.install(CHOCO_PACKAGE_NAME);
505
-
506
- if (!result.success) {
507
- throw new Error(
508
- `Failed to install Tidal via Chocolatey.\n` +
509
- `Output: ${result.output}\n\n` +
510
- `Troubleshooting:\n` +
511
- ` 1. Ensure you are running as Administrator\n` +
512
- ` 2. Run 'choco list tidal' to check availability\n` +
513
- ` 3. Try manual installation: choco install tidal -y --force`
514
- );
515
- }
516
-
517
- // Verify installation
518
- const verifyInstalled = await choco.isPackageInstalled(CHOCO_PACKAGE_NAME);
519
- if (!verifyInstalled) {
520
- throw new Error(
521
- 'Installation command completed but Tidal was not found.\n\n' +
522
- 'Please try:\n' +
523
- ' 1. Run: choco list tidal\n' +
524
- ' 2. Retry: choco install tidal -y'
525
- );
526
- }
527
-
528
- console.log('Tidal installed successfully.');
529
- console.log('');
530
- console.log('To launch Tidal:');
531
- console.log(' - Open from Start Menu, or');
532
- console.log(' - Run: Start-Process tidal:');
533
- console.log('');
534
- console.log('On first launch, you will be prompted to sign in with your');
535
- console.log('Tidal account credentials.');
536
- }
537
-
538
- /**
539
- * Install Tidal when running from Ubuntu on WSL (Windows Subsystem for Linux).
540
- *
541
- * PLATFORM APPROACH: Tidal is installed on the Windows host and accessed from
542
- * WSL. While WSL with WSLg can technically run Linux GUI applications, the
543
- * recommended approach is to install Tidal on Windows and launch it from WSL
544
- * using Windows interoperability.
545
- *
546
- * Prerequisites:
547
- * - Windows 10 version 2004 or higher, or Windows 11
548
- * - WSL 2 enabled with Ubuntu distribution installed
549
- * - Chocolatey installed on Windows for Tidal installation
550
- *
551
- * This function installs Tidal on the Windows host via PowerShell/Chocolatey,
552
- * then provides instructions for launching it from within WSL.
553
- *
554
- * @returns {Promise<void>}
555
- * @throws {Error} If installation on Windows host fails
556
- */
557
- async function install_ubuntu_wsl() {
558
- console.log('Detected Ubuntu running in WSL (Windows Subsystem for Linux).');
559
- console.log('');
560
- console.log('Installing Tidal on the Windows host...');
561
- console.log('');
562
-
563
- // Check if Tidal is already available on Windows host
564
- const tidalCheck = await shell.exec('cmd.exe /c "choco list tidal --local-only" 2>/dev/null');
565
- if (tidalCheck.code === 0 && tidalCheck.stdout.toLowerCase().includes('tidal')) {
566
- console.log('Tidal is already installed on Windows, skipping installation.');
567
- console.log('');
568
- console.log('To launch Tidal from WSL:');
569
- console.log(' cmd.exe /c start "" "tidal:"');
570
- return;
571
- }
572
-
573
- console.log('Installing Tidal via Chocolatey on Windows...');
574
- console.log('This may take a few minutes...');
575
-
576
- // Install via PowerShell using Chocolatey on the Windows host
577
- const installResult = await shell.exec(
578
- 'powershell.exe -NoProfile -Command "choco install tidal -y"'
579
- );
580
-
581
- if (installResult.code !== 0) {
582
- throw new Error(
583
- `Failed to install Tidal on Windows host.\n` +
584
- `Output: ${installResult.stdout || installResult.stderr}\n\n` +
585
- `Troubleshooting:\n` +
586
- ` 1. Ensure Chocolatey is installed on Windows\n` +
587
- ` 2. Open an Administrator PowerShell on Windows and run:\n` +
588
- ` choco install tidal -y\n` +
589
- ` 3. Then launch from WSL with: cmd.exe /c start "" "tidal:"`
590
- );
591
- }
592
-
593
- console.log('Tidal installed successfully on Windows.');
594
- console.log('');
595
- console.log('To launch Tidal from WSL:');
596
- console.log(' cmd.exe /c start "" "tidal:"');
597
- console.log('');
598
- console.log('Alternative - open Tidal web in browser:');
599
- console.log(' cmd.exe /c start https://listen.tidal.com');
600
- console.log('');
601
- console.log('TIP: Add an alias to ~/.bashrc for convenience:');
602
- console.log(' echo \'alias tidal="cmd.exe /c start https://listen.tidal.com"\' >> ~/.bashrc');
603
- }
604
-
605
- /**
606
- * Install Tidal from Git Bash on Windows.
607
- *
608
- * Git Bash runs within Windows, so this function installs Tidal on the
609
- * Windows host using Chocolatey via PowerShell interop.
610
- *
611
- * Prerequisites:
612
- * - Windows 10 or Windows 11 (64-bit)
613
- * - Git Bash installed (comes with Git for Windows)
614
- * - Chocolatey package manager installed on Windows
615
- * - Administrator privileges
616
- *
617
- * @returns {Promise<void>}
618
- * @throws {Error} If installation fails
619
- */
620
- async function install_gitbash() {
621
- console.log('Detected Git Bash on Windows.');
622
- console.log('Installing Tidal on the Windows host...');
623
- console.log('');
624
-
625
- // Check if Tidal is already installed
626
- const tidalCheck = await shell.exec('choco list tidal --local-only 2>/dev/null');
627
- if (tidalCheck.code === 0 && tidalCheck.stdout.toLowerCase().includes('tidal')) {
628
- console.log('Tidal is already installed, skipping installation.');
629
- console.log('');
630
- console.log('To launch Tidal:');
631
- console.log(' start https://listen.tidal.com');
632
- return;
633
- }
634
-
635
- console.log('Installing Tidal via Chocolatey...');
636
- console.log('This may take a few minutes...');
637
-
638
- // Install via PowerShell using Chocolatey
639
- const installResult = await shell.exec(
640
- 'powershell.exe -NoProfile -Command "choco install tidal -y"'
641
- );
642
-
643
- if (installResult.code !== 0) {
644
- throw new Error(
645
- `Failed to install Tidal.\n` +
646
- `Output: ${installResult.stdout || installResult.stderr}\n\n` +
647
- `Troubleshooting:\n` +
648
- ` 1. Ensure Chocolatey is installed on Windows\n` +
649
- ` 2. Run Git Bash as Administrator and retry\n` +
650
- ` 3. Try installing directly from PowerShell:\n` +
651
- ` choco install tidal -y`
652
- );
653
- }
654
-
655
- console.log('Tidal installed successfully.');
656
- console.log('');
657
- console.log('To launch Tidal from Git Bash:');
658
- console.log(' start https://listen.tidal.com');
659
- console.log('');
660
- console.log('Or use the explicit Windows command:');
661
- console.log(' cmd //c "start https://listen.tidal.com"');
662
- }
663
-
664
- /**
665
- * Check if Tidal is installed on the current system.
666
- * @returns {Promise<boolean>} True if Tidal is installed
667
- */
668
- async function isInstalled() {
669
- const platform = os.detect();
670
- if (platform.type === 'macos') {
671
- return brew.isCaskInstalled(HOMEBREW_CASK_NAME);
672
- }
673
- if (platform.type === 'windows') {
674
- return choco.isPackageInstalled(CHOCO_PACKAGE_NAME);
675
- }
676
- if (['ubuntu', 'debian', 'amazon_linux', 'fedora', 'rhel'].includes(platform.type)) {
677
- return isTidalHifiInstalledFlatpak();
678
- }
679
- return false;
680
- }
681
-
682
- /**
683
- * Check if this installer is supported on the current platform.
684
- * Tidal is supported on all major platforms except Raspberry Pi OS.
685
- * @returns {boolean} True if installation is supported on this platform
686
- */
687
- function isEligible() {
688
- const platform = os.detect();
689
-
690
- // First check if the platform is supported
691
- const supportedPlatforms = ['macos', 'ubuntu', 'debian', 'wsl', 'amazon_linux', 'rhel', 'fedora', 'windows', 'gitbash'];
692
- if (!supportedPlatforms.includes(platform.type)) {
693
- return false;
694
- }
695
-
696
- // This installer requires a desktop environment
697
- if (REQUIRES_DESKTOP && !os.isDesktopAvailable()) {
698
- return false;
699
- }
700
-
701
- return true;
702
- }
703
-
704
- /**
705
- * Main installation entry point.
706
- *
707
- * Detects the current platform and runs the appropriate installer function.
708
- * Handles platform-specific mappings to ensure all supported platforms
709
- * have appropriate installation logic.
710
- *
711
- * Supported platforms:
712
- * - macOS: Tidal Desktop via Homebrew cask
713
- * - Ubuntu/Debian: tidal-hifi via Flatpak (x86_64 only)
714
- * - Raspberry Pi OS: Not supported (graceful message with alternatives)
715
- * - Amazon Linux/RHEL: tidal-hifi via Flatpak (x86_64 only)
716
- * - Windows: Tidal Desktop via Chocolatey
717
- * - WSL (Ubuntu): Installs Tidal on Windows host
718
- * - Git Bash: Installs Tidal on Windows host
719
- *
720
- * @returns {Promise<void>}
721
- */
722
- async function install() {
723
- const platform = os.detect();
724
-
725
- // Map platform types to their installer functions
726
- // This mapping handles aliases and variations
727
- const installers = {
728
- 'macos': install_macos,
729
- 'ubuntu': install_ubuntu,
730
- 'debian': install_ubuntu,
731
- 'wsl': install_ubuntu_wsl,
732
- 'raspbian': install_raspbian,
733
- 'amazon_linux': install_amazon_linux,
734
- 'rhel': install_amazon_linux,
735
- 'fedora': install_amazon_linux,
736
- 'windows': install_windows,
737
- 'gitbash': install_gitbash
738
- };
739
-
740
- const installer = installers[platform.type];
741
-
742
- if (!installer) {
743
- console.log(`Tidal is not available for ${platform.type}.`);
744
- return;
745
- }
746
-
747
- await installer();
748
- }
749
-
750
- // Export all functions for use as a module and for testing
751
- module.exports = {
752
- REQUIRES_DESKTOP,
753
- install,
754
- isInstalled,
755
- isEligible,
756
- install_macos,
757
- install_ubuntu,
758
- install_ubuntu_wsl,
759
- install_raspbian,
760
- install_amazon_linux,
761
- install_windows,
762
- install_gitbash
763
- };
764
-
765
- // Allow direct execution: node tidal.js
766
- if (require.main === module) {
767
- install().catch(err => {
768
- console.error(err.message);
769
- process.exit(1);
770
- });
771
- }