@fredlackey/devutils 0.0.17 → 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 -1033
  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 -216
  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,701 +0,0 @@
1
- #!/usr/bin/env node
2
-
3
- /**
4
- * @fileoverview Install yt-dlp - a feature-rich command-line audio/video downloader.
5
- * @module installs/yt-dlp
6
- *
7
- * yt-dlp is a fork of the now-discontinued youtube-dl project, with additional
8
- * features, bug fixes, and active maintenance. It supports downloading from
9
- * YouTube, Vimeo, Twitter, TikTok, and thousands of other websites.
10
- *
11
- * Key capabilities include:
12
- * - Video downloading in various qualities and formats
13
- * - Audio extraction from videos (requires FFmpeg)
14
- * - Playlist and channel downloading
15
- * - Metadata and thumbnail embedding
16
- * - Format selection and live stream recording
17
- *
18
- * This installer provides:
19
- * - yt-dlp via Homebrew for macOS
20
- * - yt-dlp via APT for Ubuntu/Debian and Raspberry Pi OS
21
- * - yt-dlp via pip for Amazon Linux (not available in standard repos)
22
- * - yt-dlp via Chocolatey for Windows
23
- * - yt-dlp via APT for WSL (Ubuntu)
24
- * - yt-dlp via direct binary download for Git Bash
25
- *
26
- * IMPORTANT: For full functionality (format conversion, audio extraction),
27
- * install FFmpeg alongside yt-dlp using: dev install ffmpeg
28
- */
29
-
30
- const os = require('../utils/common/os');
31
- const shell = require('../utils/common/shell');
32
- const brew = require('../utils/macos/brew');
33
- const apt = require('../utils/ubuntu/apt');
34
- const choco = require('../utils/windows/choco');
35
-
36
- /**
37
- * The Homebrew formula name for yt-dlp on macOS.
38
- */
39
- const HOMEBREW_FORMULA_NAME = 'yt-dlp';
40
-
41
- /**
42
- * The APT package name for yt-dlp on Debian-based systems.
43
- */
44
- const APT_PACKAGE_NAME = 'yt-dlp';
45
-
46
- /**
47
- * The Chocolatey package name for yt-dlp on Windows.
48
- */
49
- const CHOCO_PACKAGE_NAME = 'yt-dlp';
50
-
51
- /**
52
- * Check if yt-dlp is installed by verifying the 'yt-dlp' command exists.
53
- *
54
- * This is a quick check that works across all platforms by looking for
55
- * the yt-dlp executable in the system PATH.
56
- *
57
- * @returns {boolean} True if the yt-dlp command is available, false otherwise
58
- */
59
- function isYtDlpCommandAvailable() {
60
- return shell.commandExists('yt-dlp');
61
- }
62
-
63
- /**
64
- * Check if yt-dlp is installed and get the version.
65
- *
66
- * Executes 'yt-dlp --version' to verify yt-dlp is properly installed
67
- * and operational. Returns the version string if successful.
68
- *
69
- * @returns {Promise<string|null>} yt-dlp version string, or null if not installed
70
- */
71
- async function getYtDlpVersion() {
72
- // First check if the command exists to avoid unnecessary process spawning
73
- if (!isYtDlpCommandAvailable()) {
74
- return null;
75
- }
76
-
77
- // Execute yt-dlp --version to get version information
78
- // The output format is typically just the version date: "2025.12.08"
79
- const result = await shell.exec('yt-dlp --version');
80
- if (result.code === 0 && result.stdout) {
81
- // yt-dlp version output is just the version string on a single line
82
- return result.stdout.trim();
83
- }
84
- return null;
85
- }
86
-
87
- /**
88
- * Install yt-dlp on macOS using Homebrew.
89
- *
90
- * Prerequisites:
91
- * - macOS 10.15 (Catalina) or later
92
- * - Homebrew package manager installed
93
- * - Xcode Command Line Tools installed
94
- *
95
- * Homebrew installs yt-dlp with all its dependencies, including Python.
96
- * For full functionality, FFmpeg should also be installed separately.
97
- *
98
- * @returns {Promise<void>}
99
- */
100
- async function install_macos() {
101
- console.log('Checking if yt-dlp is already installed...');
102
-
103
- // Check if yt-dlp is already installed via command availability
104
- const existingVersion = await getYtDlpVersion();
105
- if (existingVersion) {
106
- console.log(`yt-dlp ${existingVersion} is already installed, skipping installation.`);
107
- return;
108
- }
109
-
110
- // Also check if the formula is installed via Homebrew
111
- // (yt-dlp may be installed but not in PATH for some reason)
112
- const formulaInstalled = await brew.isFormulaInstalled(HOMEBREW_FORMULA_NAME);
113
- if (formulaInstalled) {
114
- console.log('yt-dlp is already installed via Homebrew, skipping installation.');
115
- console.log('');
116
- console.log('NOTE: If yt-dlp commands are not working, check your PATH.');
117
- console.log('Run: brew info yt-dlp');
118
- return;
119
- }
120
-
121
- // Verify Homebrew is available before attempting installation
122
- if (!brew.isInstalled()) {
123
- console.log('Homebrew is not installed. Please install Homebrew first.');
124
- console.log('Run: dev install homebrew');
125
- return;
126
- }
127
-
128
- console.log('Installing yt-dlp via Homebrew...');
129
-
130
- // Install yt-dlp formula using Homebrew utility
131
- const result = await brew.install(HOMEBREW_FORMULA_NAME);
132
-
133
- if (!result.success) {
134
- console.log('Failed to install yt-dlp via Homebrew.');
135
- console.log(result.output);
136
- return;
137
- }
138
-
139
- // Verify installation succeeded by checking if the command now exists
140
- const version = await getYtDlpVersion();
141
- if (!version) {
142
- console.log('Installation may have failed: yt-dlp command not found after install.');
143
- console.log('');
144
- console.log('Please try:');
145
- console.log(' 1. Restart your terminal session');
146
- console.log(' 2. Run: yt-dlp --version');
147
- return;
148
- }
149
-
150
- console.log(`yt-dlp ${version} installed successfully.`);
151
- console.log('');
152
- console.log('RECOMMENDED: Install FFmpeg for full format conversion support:');
153
- console.log(' dev install ffmpeg');
154
- console.log('');
155
- console.log('Verify installation with: yt-dlp --version');
156
- }
157
-
158
- /**
159
- * Install yt-dlp on Ubuntu/Debian using APT.
160
- *
161
- * Prerequisites:
162
- * - Ubuntu 22.04 LTS or later, or Debian 11 (Bullseye) or later
163
- * - sudo privileges
164
- * - At least 100 MB free disk space
165
- *
166
- * Note: The version available in Ubuntu/Debian repositories may not be the
167
- * latest, but is sufficient for most use cases. For the latest version,
168
- * consider using pip installation method.
169
- *
170
- * @returns {Promise<void>}
171
- */
172
- async function install_ubuntu() {
173
- console.log('Checking if yt-dlp is already installed...');
174
-
175
- // Check if yt-dlp is already installed
176
- const existingVersion = await getYtDlpVersion();
177
- if (existingVersion) {
178
- console.log(`yt-dlp ${existingVersion} is already installed, skipping installation.`);
179
- return;
180
- }
181
-
182
- // Update package lists before installing to ensure we get the latest available version
183
- console.log('Updating package lists...');
184
- const updateResult = await apt.update();
185
- if (!updateResult.success) {
186
- console.log('Warning: Failed to update package lists. Continuing with installation...');
187
- }
188
-
189
- // Install yt-dlp using APT
190
- // The apt.install function uses DEBIAN_FRONTEND=noninteractive and -y flag
191
- console.log('Installing yt-dlp via APT...');
192
- const result = await apt.install(APT_PACKAGE_NAME);
193
-
194
- if (!result.success) {
195
- console.log('Failed to install yt-dlp via APT.');
196
- console.log(result.output);
197
- console.log('');
198
- console.log('If the package is not available, you can install via pip:');
199
- console.log(' sudo apt-get install -y python3-pip');
200
- console.log(' python3 -m pip install -U "yt-dlp[default]"');
201
- return;
202
- }
203
-
204
- // Verify the installation succeeded by checking if the command exists
205
- const version = await getYtDlpVersion();
206
- if (!version) {
207
- console.log('Installation may have failed: yt-dlp command not found after install.');
208
- return;
209
- }
210
-
211
- console.log(`yt-dlp ${version} installed successfully.`);
212
- console.log('');
213
- console.log('NOTE: The repository version may not be the latest.');
214
- console.log('For the latest version, use pip: python3 -m pip install -U "yt-dlp[default]"');
215
- console.log('');
216
- console.log('RECOMMENDED: Install FFmpeg for full format conversion support:');
217
- console.log(' dev install ffmpeg');
218
- }
219
-
220
- /**
221
- * Install yt-dlp on Ubuntu running in WSL (Windows Subsystem for Linux).
222
- *
223
- * Prerequisites:
224
- * - Windows 10 version 2004 or higher, or Windows 11
225
- * - WSL 2 enabled with Ubuntu distribution installed
226
- * - sudo privileges within WSL
227
- *
228
- * yt-dlp installed in Windows is not accessible from WSL, so this function
229
- * installs yt-dlp separately within the WSL Ubuntu environment using APT.
230
- * The installation process is identical to native Ubuntu.
231
- *
232
- * @returns {Promise<void>}
233
- */
234
- async function install_ubuntu_wsl() {
235
- console.log('Detected Ubuntu running in WSL (Windows Subsystem for Linux).');
236
- console.log('');
237
- console.log('Installing yt-dlp within WSL environment...');
238
- console.log('');
239
-
240
- // Check if yt-dlp is already installed
241
- const existingVersion = await getYtDlpVersion();
242
- if (existingVersion) {
243
- console.log(`yt-dlp ${existingVersion} is already installed, skipping installation.`);
244
- return;
245
- }
246
-
247
- // Update package lists before installing
248
- console.log('Updating package lists...');
249
- const updateResult = await apt.update();
250
- if (!updateResult.success) {
251
- console.log('Warning: Failed to update package lists. Continuing with installation...');
252
- }
253
-
254
- // Install yt-dlp using APT
255
- console.log('Installing yt-dlp via APT...');
256
- const result = await apt.install(APT_PACKAGE_NAME);
257
-
258
- if (!result.success) {
259
- console.log('Failed to install yt-dlp via APT.');
260
- console.log(result.output);
261
- console.log('');
262
- console.log('Troubleshooting:');
263
- console.log(' 1. If you see DNS errors, try:');
264
- console.log(' echo "nameserver 8.8.8.8" | sudo tee /etc/resolv.conf');
265
- console.log(' 2. Alternatively, install via pip:');
266
- console.log(' sudo apt-get install -y python3-pip');
267
- console.log(' python3 -m pip install -U "yt-dlp[default]"');
268
- return;
269
- }
270
-
271
- // Verify installation succeeded
272
- const version = await getYtDlpVersion();
273
- if (!version) {
274
- console.log('Installation may have failed: yt-dlp command not found after install.');
275
- return;
276
- }
277
-
278
- console.log(`yt-dlp ${version} installed successfully.`);
279
- console.log('');
280
- console.log('WSL NOTES:');
281
- console.log(' - Access Windows files through /mnt/c/, /mnt/d/, etc.');
282
- console.log(' - Example: yt-dlp -o "/mnt/c/Users/You/Downloads/%(title)s.%(ext)s" "URL"');
283
- console.log('');
284
- console.log('RECOMMENDED: Install FFmpeg for full format conversion support:');
285
- console.log(' dev install ffmpeg');
286
- }
287
-
288
- /**
289
- * Install yt-dlp on Raspberry Pi OS using APT.
290
- *
291
- * Prerequisites:
292
- * - Raspberry Pi OS (Bookworm or Bullseye), 32-bit or 64-bit
293
- * - Raspberry Pi 3 or later recommended (earlier models work but may be slow)
294
- * - sudo privileges
295
- * - At least 100 MB free disk space
296
- *
297
- * The yt-dlp package in the repositories is architecture-independent (pure Python)
298
- * and works on ARM processors without modification.
299
- *
300
- * @returns {Promise<void>}
301
- */
302
- async function install_raspbian() {
303
- console.log('Checking if yt-dlp is already installed...');
304
-
305
- // Check if yt-dlp is already installed
306
- const existingVersion = await getYtDlpVersion();
307
- if (existingVersion) {
308
- console.log(`yt-dlp ${existingVersion} is already installed, skipping installation.`);
309
- return;
310
- }
311
-
312
- // Update package lists before installing
313
- console.log('Updating package lists...');
314
- const updateResult = await apt.update();
315
- if (!updateResult.success) {
316
- console.log('Warning: Failed to update package lists. Continuing with installation...');
317
- }
318
-
319
- // Install yt-dlp using APT
320
- console.log('Installing yt-dlp via APT...');
321
- const result = await apt.install(APT_PACKAGE_NAME);
322
-
323
- if (!result.success) {
324
- console.log('Failed to install yt-dlp via APT.');
325
- console.log(result.output);
326
- console.log('');
327
- console.log('If the package is not available on older Raspberry Pi OS, use pip:');
328
- console.log(' sudo apt-get install -y python3-pip');
329
- console.log(' python3 -m pip install -U "yt-dlp[default]"');
330
- return;
331
- }
332
-
333
- // Verify installation succeeded
334
- const version = await getYtDlpVersion();
335
- if (!version) {
336
- console.log('Installation may have failed: yt-dlp command not found after install.');
337
- return;
338
- }
339
-
340
- console.log(`yt-dlp ${version} installed successfully.`);
341
- console.log('');
342
- console.log('RASPBERRY PI NOTES:');
343
- console.log(' - Downloads may be slow on older Pi models');
344
- console.log(' - Use lower quality for faster downloads: yt-dlp -f "best[height<=720]" "URL"');
345
- console.log('');
346
- console.log('RECOMMENDED: Install FFmpeg for full format conversion support:');
347
- console.log(' dev install ffmpeg');
348
- }
349
-
350
- /**
351
- * Install yt-dlp on Amazon Linux using pip.
352
- *
353
- * Prerequisites:
354
- * - Amazon Linux 2023 (AL2023) or Amazon Linux 2 (AL2)
355
- * - sudo privileges
356
- * - At least 100 MB free disk space
357
- * - Python 3.9 or later
358
- *
359
- * IMPORTANT: yt-dlp is not available in the standard Amazon Linux repositories.
360
- * This function uses pip installation, which is the recommended approach.
361
- *
362
- * @returns {Promise<void>}
363
- */
364
- async function install_amazon_linux() {
365
- console.log('Checking if yt-dlp is already installed...');
366
-
367
- // Check if yt-dlp is already installed
368
- const existingVersion = await getYtDlpVersion();
369
- if (existingVersion) {
370
- console.log(`yt-dlp ${existingVersion} is already installed, skipping installation.`);
371
- return;
372
- }
373
-
374
- // Detect the platform to determine which package manager to use for pip
375
- // Amazon Linux 2023 uses dnf, Amazon Linux 2 uses yum
376
- const platform = os.detect();
377
- const packageManager = platform.packageManager;
378
-
379
- // First, ensure python3-pip is installed
380
- console.log('Ensuring Python pip is installed...');
381
- const pipInstallCommand = packageManager === 'dnf'
382
- ? 'sudo dnf install -y python3-pip'
383
- : 'sudo yum install -y python3-pip';
384
-
385
- const pipResult = await shell.exec(pipInstallCommand);
386
- if (pipResult.code !== 0) {
387
- console.log('Failed to install python3-pip.');
388
- console.log(pipResult.stderr || pipResult.stdout);
389
- return;
390
- }
391
-
392
- // Install yt-dlp using pip
393
- // The [default] extra installs recommended dependencies for optimal functionality
394
- console.log('Installing yt-dlp via pip...');
395
- const installResult = await shell.exec('python3 -m pip install -U "yt-dlp[default]"');
396
-
397
- if (installResult.code !== 0) {
398
- console.log('Failed to install yt-dlp via pip.');
399
- console.log(installResult.stderr || installResult.stdout);
400
- console.log('');
401
- console.log('Troubleshooting:');
402
- console.log(' 1. Try installing with --user flag:');
403
- console.log(' python3 -m pip install --user -U "yt-dlp[default]"');
404
- console.log(' 2. Ensure ~/.local/bin is in your PATH:');
405
- console.log(' echo \'export PATH="$HOME/.local/bin:$PATH"\' >> ~/.bashrc');
406
- console.log(' source ~/.bashrc');
407
- return;
408
- }
409
-
410
- // Check if ~/.local/bin is in PATH (common location for pip-installed binaries)
411
- const pathCheckResult = await shell.exec('echo $PATH | grep -q "$HOME/.local/bin"');
412
- if (pathCheckResult.code !== 0) {
413
- console.log('Adding ~/.local/bin to PATH...');
414
- await shell.exec('echo \'export PATH="$HOME/.local/bin:$PATH"\' >> ~/.bashrc');
415
- console.log('');
416
- console.log('IMPORTANT: Run "source ~/.bashrc" or restart your terminal to update PATH.');
417
- }
418
-
419
- // Verify installation succeeded
420
- // Note: We may need to check with the full path since PATH may not be updated yet
421
- let version = await getYtDlpVersion();
422
- if (!version) {
423
- // Try checking the version using the full path
424
- const fullPathResult = await shell.exec('$HOME/.local/bin/yt-dlp --version');
425
- if (fullPathResult.code === 0 && fullPathResult.stdout) {
426
- version = fullPathResult.stdout.trim();
427
- }
428
- }
429
-
430
- if (!version) {
431
- console.log('Installation may have failed or yt-dlp is not in PATH.');
432
- console.log('');
433
- console.log('Please try:');
434
- console.log(' 1. Add ~/.local/bin to PATH:');
435
- console.log(' echo \'export PATH="$HOME/.local/bin:$PATH"\' >> ~/.bashrc');
436
- console.log(' source ~/.bashrc');
437
- console.log(' 2. Run: yt-dlp --version');
438
- return;
439
- }
440
-
441
- console.log(`yt-dlp ${version} installed successfully.`);
442
- console.log('');
443
- console.log('RECOMMENDED: Install FFmpeg for full format conversion support:');
444
- console.log(' dev install ffmpeg');
445
- }
446
-
447
- /**
448
- * Install yt-dlp on Windows using Chocolatey.
449
- *
450
- * Prerequisites:
451
- * - Windows 10 or later (64-bit)
452
- * - Administrator PowerShell or Command Prompt
453
- * - Chocolatey package manager installed
454
- *
455
- * Chocolatey installs yt-dlp and adds it to the system PATH automatically.
456
- * A new terminal window may be required for PATH updates to take effect.
457
- *
458
- * @returns {Promise<void>}
459
- */
460
- async function install_windows() {
461
- console.log('Checking if yt-dlp is already installed...');
462
-
463
- // Check if yt-dlp is already installed via command availability
464
- const existingVersion = await getYtDlpVersion();
465
- if (existingVersion) {
466
- console.log(`yt-dlp ${existingVersion} is already installed, skipping installation.`);
467
- return;
468
- }
469
-
470
- // Check if yt-dlp is installed via Chocolatey
471
- const packageInstalled = await choco.isPackageInstalled(CHOCO_PACKAGE_NAME);
472
- if (packageInstalled) {
473
- console.log('yt-dlp is already installed via Chocolatey, skipping installation.');
474
- console.log('');
475
- console.log('NOTE: If yt-dlp commands are not working, open a new terminal window');
476
- console.log('to refresh your PATH, or run: refreshenv');
477
- return;
478
- }
479
-
480
- // Verify Chocolatey is available before attempting installation
481
- if (!choco.isInstalled()) {
482
- console.log('Chocolatey is not installed. Please install Chocolatey first.');
483
- console.log('Run: dev install chocolatey');
484
- return;
485
- }
486
-
487
- console.log('Installing yt-dlp via Chocolatey...');
488
-
489
- // Install yt-dlp using Chocolatey utility
490
- const result = await choco.install(CHOCO_PACKAGE_NAME);
491
-
492
- if (!result.success) {
493
- console.log('Failed to install yt-dlp via Chocolatey.');
494
- console.log(result.output);
495
- return;
496
- }
497
-
498
- console.log('yt-dlp installed successfully.');
499
- console.log('');
500
- console.log('IMPORTANT: Open a new terminal window to refresh your PATH.');
501
- console.log('Alternatively, run: refreshenv');
502
- console.log('');
503
- console.log('RECOMMENDED: Install FFmpeg for full format conversion support:');
504
- console.log(' dev install ffmpeg');
505
- console.log('');
506
- console.log('Verify installation with: yt-dlp --version');
507
- }
508
-
509
- /**
510
- * Install yt-dlp in Git Bash on Windows using direct binary download.
511
- *
512
- * Prerequisites:
513
- * - Windows 10 or later (64-bit)
514
- * - Git Bash installed (comes with Git for Windows)
515
- * - Internet access to download binaries from GitHub
516
- *
517
- * Git Bash runs in a MinGW environment on Windows. This function downloads
518
- * the portable yt-dlp Windows executable from GitHub releases and places
519
- * it in ~/bin which is added to PATH.
520
- *
521
- * @returns {Promise<void>}
522
- */
523
- async function install_gitbash() {
524
- console.log('Detected Git Bash on Windows.');
525
- console.log('');
526
- console.log('Installing yt-dlp using direct binary download...');
527
- console.log('');
528
-
529
- // Check if yt-dlp is already available
530
- const existingVersion = await getYtDlpVersion();
531
- if (existingVersion) {
532
- console.log(`yt-dlp ${existingVersion} is already installed, skipping installation.`);
533
- return;
534
- }
535
-
536
- // Create ~/bin directory if it does not exist
537
- // This directory will be added to PATH for storing portable executables
538
- console.log('Creating ~/bin directory...');
539
- const mkdirResult = await shell.exec('mkdir -p ~/bin');
540
- if (mkdirResult.code !== 0) {
541
- console.log('Failed to create ~/bin directory.');
542
- console.log(mkdirResult.stderr);
543
- return;
544
- }
545
-
546
- // Download the yt-dlp Windows executable from GitHub releases
547
- // Using the 'latest' URL which always points to the most recent release
548
- console.log('Downloading yt-dlp from GitHub releases...');
549
- const downloadUrl = 'https://github.com/yt-dlp/yt-dlp/releases/latest/download/yt-dlp.exe';
550
- const downloadCommand = `curl -L -o ~/bin/yt-dlp.exe "${downloadUrl}"`;
551
- const downloadResult = await shell.exec(downloadCommand);
552
-
553
- if (downloadResult.code !== 0) {
554
- console.log('Failed to download yt-dlp binary.');
555
- console.log(downloadResult.stderr || downloadResult.stdout);
556
- console.log('');
557
- console.log('Troubleshooting:');
558
- console.log(' 1. Check your internet connection');
559
- console.log(' 2. If you see certificate errors, try:');
560
- console.log(` curl -k -L -o ~/bin/yt-dlp.exe "${downloadUrl}"`);
561
- return;
562
- }
563
-
564
- // Make the executable file executable (may not be necessary on Windows but ensures consistency)
565
- await shell.exec('chmod +x ~/bin/yt-dlp.exe 2>/dev/null || true');
566
-
567
- // Check if ~/bin is in PATH and add it if needed
568
- const pathCheckResult = await shell.exec('echo $PATH | grep -q "$HOME/bin"');
569
- if (pathCheckResult.code !== 0) {
570
- console.log('Adding ~/bin to PATH in ~/.bashrc...');
571
- await shell.exec('echo \'export PATH="$HOME/bin:$PATH"\' >> ~/.bashrc');
572
- console.log('');
573
- console.log('IMPORTANT: Run "source ~/.bashrc" or restart Git Bash to update PATH.');
574
- }
575
-
576
- // Verify installation by checking the version using the full path
577
- // (PATH may not be updated yet in the current session)
578
- const verifyResult = await shell.exec('~/bin/yt-dlp.exe --version');
579
- if (verifyResult.code !== 0) {
580
- console.log('Installation may have failed or verification failed.');
581
- console.log('');
582
- console.log('Please try:');
583
- console.log(' 1. Restart Git Bash');
584
- console.log(' 2. Run: ~/bin/yt-dlp.exe --version');
585
- return;
586
- }
587
-
588
- const version = verifyResult.stdout.trim();
589
-
590
- console.log(`yt-dlp ${version} installed successfully.`);
591
- console.log('');
592
- console.log('Installation location: ~/bin/yt-dlp.exe');
593
- console.log('');
594
- console.log('GIT BASH NOTES:');
595
- console.log(' - For Windows paths, use forward slashes or MSYS path format');
596
- console.log(' - Example: yt-dlp -o "//c/Users/You/Downloads/%(title)s.%(ext)s" "URL"');
597
- console.log(' - Or use: MSYS_NO_PATHCONV=1 yt-dlp -o "C:/Users/..." "URL"');
598
- console.log('');
599
- console.log('RECOMMENDED: Install FFmpeg for full format conversion support:');
600
- console.log(' dev install ffmpeg');
601
- console.log('');
602
- console.log('Restart Git Bash or run: source ~/.bashrc');
603
- }
604
-
605
- /**
606
- * Check if yt-dlp is installed on the current system.
607
- * @returns {Promise<boolean>} True if yt-dlp is installed
608
- */
609
- async function isInstalled() {
610
- const platform = os.detect();
611
- if (platform.type === 'macos') {
612
- return brew.isFormulaInstalled(HOMEBREW_FORMULA_NAME);
613
- }
614
- if (platform.type === 'windows') {
615
- return choco.isPackageInstalled(CHOCO_PACKAGE_NAME);
616
- }
617
- if (['ubuntu', 'debian', 'raspbian'].includes(platform.type)) {
618
- return apt.isPackageInstalled(APT_PACKAGE_NAME);
619
- }
620
- return isYtDlpCommandAvailable();
621
- }
622
-
623
- /**
624
- * Check if this installer is supported on the current platform.
625
- * yt-dlp is supported on all major platforms.
626
- * @returns {boolean} True if installation is supported on this platform
627
- */
628
- function isEligible() {
629
- const platform = os.detect();
630
- return ['macos', 'ubuntu', 'debian', 'wsl', 'raspbian', 'amazon_linux', 'fedora', 'rhel', 'windows', 'gitbash'].includes(platform.type);
631
- }
632
-
633
- /**
634
- * Main installation entry point.
635
- *
636
- * Detects the current platform and runs the appropriate installer function.
637
- * Handles platform-specific mappings to ensure all supported platforms
638
- * have appropriate installation logic.
639
- *
640
- * Supported platforms:
641
- * - macOS: yt-dlp via Homebrew
642
- * - Ubuntu/Debian: yt-dlp via APT
643
- * - Raspberry Pi OS: yt-dlp via APT
644
- * - Amazon Linux/RHEL: yt-dlp via pip (not in standard repos)
645
- * - Windows: yt-dlp via Chocolatey
646
- * - WSL (Ubuntu): yt-dlp via APT within WSL
647
- * - Git Bash: yt-dlp direct binary download from GitHub
648
- *
649
- * @returns {Promise<void>}
650
- */
651
- async function install() {
652
- const platform = os.detect();
653
-
654
- // Map platform types to their installer functions
655
- // This mapping handles aliases (e.g., debian maps to ubuntu installer)
656
- const installers = {
657
- 'macos': install_macos,
658
- 'ubuntu': install_ubuntu,
659
- 'debian': install_ubuntu,
660
- 'wsl': install_ubuntu_wsl,
661
- 'raspbian': install_raspbian,
662
- 'amazon_linux': install_amazon_linux,
663
- 'rhel': install_amazon_linux,
664
- 'fedora': install_amazon_linux,
665
- 'windows': install_windows,
666
- 'gitbash': install_gitbash
667
- };
668
-
669
- const installer = installers[platform.type];
670
-
671
- // If no installer exists for this platform, inform the user gracefully
672
- // Do not throw an error - just log a message and return
673
- if (!installer) {
674
- console.log(`yt-dlp is not available for ${platform.type}.`);
675
- return;
676
- }
677
-
678
- await installer();
679
- }
680
-
681
- // Export all functions for use as a module and for testing
682
- module.exports = {
683
- install,
684
- isInstalled,
685
- isEligible,
686
- install_macos,
687
- install_ubuntu,
688
- install_ubuntu_wsl,
689
- install_raspbian,
690
- install_amazon_linux,
691
- install_windows,
692
- install_gitbash
693
- };
694
-
695
- // Allow direct execution: node yt-dlp.js
696
- if (require.main === module) {
697
- install().catch(err => {
698
- console.error(err.message);
699
- process.exit(1);
700
- });
701
- }