@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,813 +0,0 @@
1
- # Installing Beyond Compare
2
-
3
- ## Overview
4
-
5
- Beyond Compare is a powerful file and folder comparison utility developed by Scooter Software. It enables users to compare files, folders, and even entire drives with detailed side-by-side visualization of differences. Beyond Compare supports merging changes between two or three versions of files, synchronizing files and folders between different locations (including FTP, SFTP, WebDAV, and cloud storage), and generating comparison reports. The tool includes specialized comparison viewers for text files, binary files, images, tables, registry hives, and more. Beyond Compare is widely used by software developers, IT professionals, and anyone who needs to efficiently compare, synchronize, and merge files.
6
-
7
- **Note**: Beyond Compare is commercial software. Downloads include both Standard and Pro functionality, with your license key unlocking the appropriate features for permanent use. A 30-day trial is available.
8
-
9
- ## Prerequisites
10
-
11
- Before installing Beyond Compare on any platform, ensure:
12
-
13
- 1. **Internet connectivity** - Required to download the installer or packages
14
- 2. **Administrative privileges** - Required for system-wide installation on most platforms
15
- 3. **64-bit operating system** - Beyond Compare 5 requires a 64-bit (x86_64/AMD64) system on all platforms
16
- 4. **Graphical environment** - Beyond Compare is a GUI application and requires a display (X11 on Linux, GUI on Windows/macOS)
17
-
18
- **Important**: Beyond Compare does NOT support ARM processors (including Apple Silicon natively, Raspberry Pi, or ARM-based Linux systems). On Apple Silicon Macs, it runs through Rosetta 2 translation. ARM Linux systems are not supported.
19
-
20
- ## Dependencies
21
-
22
- ### macOS (Homebrew)
23
- - **Required:**
24
- - Homebrew package manager - Install via `/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"`
25
- - **Optional:**
26
- - Rosetta 2 (for Apple Silicon Macs) - Usually auto-prompted by macOS when needed, or install manually via `softwareupdate --install-rosetta --agree-to-license`
27
- - **Auto-installed:** None
28
-
29
- ### Ubuntu (APT/Snap)
30
- - **Required:**
31
- - `wget` - Install via `sudo apt install wget` (installer will auto-install if missing)
32
- - **Optional:** None
33
- - **Auto-installed:**
34
- - GTK3 libraries, X11 libraries, and other GUI dependencies (handled by APT when installing the .deb package)
35
-
36
- ### Raspberry Pi OS (APT/Snap)
37
- - **Installation not supported on this platform** - Beyond Compare does not support ARM architecture. Use alternatives like Meld (`sudo apt install meld`), KDiff3 (`sudo apt install kdiff3`), or vimdiff (`sudo apt install vim`).
38
-
39
- ### Amazon Linux (DNF/YUM)
40
- - **Required:**
41
- - `wget` - Install via `sudo dnf install wget` or `sudo yum install wget` (installer will auto-install if missing)
42
- - **Optional:** None
43
- - **Auto-installed:**
44
- - GTK3 libraries, X11 libraries (libXScrnSaver), and other GUI dependencies (handled by DNF/YUM when installing the .rpm package)
45
-
46
- ### Windows (Chocolatey)
47
- - **Required:**
48
- - Chocolatey package manager - Install via PowerShell (Administrator): `Set-ExecutionPolicy Bypass -Scope Process -Force; [System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072; iex ((New-Object System.Net.WebClient).DownloadString('https://community.chocolatey.org/install.ps1'))`
49
- - **Optional:** None
50
- - **Auto-installed:**
51
- - .NET Framework and other Windows runtime dependencies (handled by Chocolatey)
52
-
53
- ### Git Bash (Manual/Portable)
54
- - **Required:**
55
- - Beyond Compare installed on Windows - See Windows section above for installation via Chocolatey or download from https://www.scootersoftware.com/download
56
- - **Optional:**
57
- - Chocolatey (for automated installation from Git Bash) - See Windows section for installation
58
- - **Auto-installed:** None (Git Bash inherits the Windows PATH and uses the Windows installation)
59
-
60
- ## Platform-Specific Installation
61
-
62
- ### macOS (Homebrew)
63
-
64
- #### Prerequisites
65
-
66
- - macOS 11 (Big Sur) or later
67
- - Homebrew package manager installed
68
- - Terminal access
69
- - Apple Silicon Macs: Rosetta 2 will be used automatically (Beyond Compare is Intel-only)
70
-
71
- If Homebrew is not installed, install it first:
72
-
73
- ```bash
74
- /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
75
- ```
76
-
77
- #### Installation Steps
78
-
79
- Run the following command to install Beyond Compare:
80
-
81
- ```bash
82
- brew install --cask --quiet beyond-compare
83
- ```
84
-
85
- The `--quiet` flag suppresses non-essential output, making the command suitable for automation scripts. The `--cask` flag is required because Beyond Compare is a macOS application (not a command-line formula).
86
-
87
- #### Verification
88
-
89
- Confirm the installation succeeded:
90
-
91
- ```bash
92
- ls /Applications/Beyond\ Compare.app && echo "Beyond Compare installed successfully"
93
- ```
94
-
95
- Launch Beyond Compare to verify it runs:
96
-
97
- ```bash
98
- open -a "Beyond Compare"
99
- ```
100
-
101
- #### Installing Command Line Tools
102
-
103
- After installation, enable command-line access by launching Beyond Compare and selecting:
104
-
105
- **Beyond Compare menu > Install Command Line Tools**
106
-
107
- This creates two command-line shortcuts:
108
- - `/usr/local/bin/bcomp` - Launches comparison and waits for completion (useful for scripts)
109
- - `/usr/local/bin/bcompare` - Launches comparison and returns immediately
110
-
111
- Verify command-line tools:
112
-
113
- ```bash
114
- bcompare --version
115
- ```
116
-
117
- #### Troubleshooting
118
-
119
- **Problem**: `beyond-compare: cask not found`
120
-
121
- **Solution**: Update Homebrew cask definitions:
122
-
123
- ```bash
124
- brew update
125
- ```
126
-
127
- **Problem**: Application crashes on Apple Silicon Mac
128
-
129
- **Solution**: Ensure Rosetta 2 is installed:
130
-
131
- ```bash
132
- softwareupdate --install-rosetta --agree-to-license
133
- ```
134
-
135
- **Problem**: `bcomp: command not found` after installing command-line tools
136
-
137
- **Solution**: Ensure `/usr/local/bin` is in your PATH. Add to `~/.zshrc`:
138
-
139
- ```bash
140
- export PATH="/usr/local/bin:$PATH"
141
- ```
142
-
143
- ---
144
-
145
- ### Ubuntu/Debian (APT)
146
-
147
- #### Prerequisites
148
-
149
- - Ubuntu 18.04 or later, or Debian 10 or later (64-bit x86_64 only)
150
- - X Window System (graphical environment required)
151
- - sudo privileges
152
- - `wget` installed (pre-installed on most systems)
153
-
154
- #### Installation Steps
155
-
156
- Download and install Beyond Compare using the official .deb package:
157
-
158
- ```bash
159
- wget -q -O /tmp/bcompare.deb "https://www.scootersoftware.com/files/bcompare-5.1.7.31736_amd64.deb" && \
160
- sudo DEBIAN_FRONTEND=noninteractive apt-get update -y && \
161
- sudo DEBIAN_FRONTEND=noninteractive apt-get install -y /tmp/bcompare.deb && \
162
- rm -f /tmp/bcompare.deb
163
- ```
164
-
165
- The `DEBIAN_FRONTEND=noninteractive` environment variable ensures no interactive prompts appear during installation. The `-y` flag automatically confirms package installation.
166
-
167
- **Note**: Installing the .deb package automatically adds the Scooter Software repository to your system for future updates.
168
-
169
- #### Preventing Automatic Repository Addition
170
-
171
- If you do not want the Scooter Software repository added to your system, create a configuration file before installation:
172
-
173
- ```bash
174
- sudo touch /etc/default/bcompare
175
- wget -q -O /tmp/bcompare.deb "https://www.scootersoftware.com/files/bcompare-5.1.7.31736_amd64.deb" && \
176
- sudo DEBIAN_FRONTEND=noninteractive apt-get update -y && \
177
- sudo DEBIAN_FRONTEND=noninteractive apt-get install -y /tmp/bcompare.deb && \
178
- rm -f /tmp/bcompare.deb
179
- ```
180
-
181
- #### Verification
182
-
183
- Confirm the installation succeeded:
184
-
185
- ```bash
186
- bcompare --version
187
- ```
188
-
189
- Expected output (version numbers may vary):
190
-
191
- ```
192
- Beyond Compare Version 5.1.7 (build 31736)
193
- ```
194
-
195
- Alternatively, verify the package is installed:
196
-
197
- ```bash
198
- dpkg -l | grep bcompare
199
- ```
200
-
201
- #### Troubleshooting
202
-
203
- **Problem**: `wget: command not found`
204
-
205
- **Solution**: Install wget first:
206
-
207
- ```bash
208
- sudo DEBIAN_FRONTEND=noninteractive apt-get update -y && sudo DEBIAN_FRONTEND=noninteractive apt-get install -y wget
209
- ```
210
-
211
- **Problem**: Dependency errors during installation
212
-
213
- **Solution**: Install missing dependencies:
214
-
215
- ```bash
216
- sudo DEBIAN_FRONTEND=noninteractive apt-get install -y -f
217
- ```
218
-
219
- **Problem**: Beyond Compare fails to launch with display errors
220
-
221
- **Solution**: Ensure you have a graphical environment. Beyond Compare requires X11. If running over SSH, use X11 forwarding:
222
-
223
- ```bash
224
- ssh -X user@host
225
- ```
226
-
227
- **Problem**: Cannot run bcompare command
228
-
229
- **Solution**: The binary is installed to `/usr/bin/bcompare`. Verify it is in PATH:
230
-
231
- ```bash
232
- which bcompare
233
- ```
234
-
235
- ---
236
-
237
- ### Raspberry Pi OS (APT)
238
-
239
- #### Prerequisites
240
-
241
- **Important**: Beyond Compare does NOT support ARM architecture. Raspberry Pi devices use ARM processors (armv7l or aarch64), which are not supported by Beyond Compare.
242
-
243
- This is a fundamental limitation of Beyond Compare, not a packaging issue. Scooter Software has stated they do not have plans to support ARM CPUs due to limited development resources.
244
-
245
- #### Alternative Solutions
246
-
247
- For file comparison needs on Raspberry Pi, use one of these open-source alternatives that support ARM:
248
-
249
- **Meld** (graphical diff tool):
250
-
251
- ```bash
252
- sudo DEBIAN_FRONTEND=noninteractive apt-get update -y && \
253
- sudo DEBIAN_FRONTEND=noninteractive apt-get install -y meld
254
- ```
255
-
256
- **KDiff3** (graphical diff and merge tool):
257
-
258
- ```bash
259
- sudo DEBIAN_FRONTEND=noninteractive apt-get update -y && \
260
- sudo DEBIAN_FRONTEND=noninteractive apt-get install -y kdiff3
261
- ```
262
-
263
- **vimdiff** (terminal-based diff tool):
264
-
265
- ```bash
266
- sudo DEBIAN_FRONTEND=noninteractive apt-get update -y && \
267
- sudo DEBIAN_FRONTEND=noninteractive apt-get install -y vim
268
- ```
269
-
270
- Then use `vimdiff file1 file2` to compare files.
271
-
272
- #### Verification
273
-
274
- Verify your architecture to confirm ARM:
275
-
276
- ```bash
277
- uname -m
278
- ```
279
-
280
- If this outputs `armv7l` or `aarch64`, your system is ARM-based and Beyond Compare is not available.
281
-
282
- #### Troubleshooting
283
-
284
- **Problem**: User attempts to install the amd64.deb package on Raspberry Pi
285
-
286
- **Solution**: This will fail with an architecture mismatch error. There is no workaround. Use one of the alternative tools listed above.
287
-
288
- ---
289
-
290
- ### Amazon Linux/RHEL (DNF/YUM)
291
-
292
- #### Prerequisites
293
-
294
- - Amazon Linux 2023, Amazon Linux 2, RHEL 8/9/10, Fedora 41+, or CentOS Stream (64-bit x86_64 only)
295
- - X Window System (graphical environment required)
296
- - sudo or root privileges
297
- - `wget` installed
298
-
299
- **Note**: Amazon Linux EC2 instances typically run headless (no GUI). Beyond Compare requires a graphical environment. For server use cases, consider using command-line diff tools instead, or access Beyond Compare via X11 forwarding.
300
-
301
- #### Installation Steps
302
-
303
- **For Amazon Linux 2023, RHEL 8/9, Fedora:**
304
-
305
- Download and install Beyond Compare using the official .rpm package:
306
-
307
- ```bash
308
- wget -q -O /tmp/bcompare.rpm "https://www.scootersoftware.com/files/bcompare-5.1.7.31736.x86_64.rpm" && \
309
- sudo dnf install -y /tmp/bcompare.rpm && \
310
- rm -f /tmp/bcompare.rpm
311
- ```
312
-
313
- **For Amazon Linux 2, RHEL 7, CentOS 7:**
314
-
315
- Use YUM instead of DNF:
316
-
317
- ```bash
318
- wget -q -O /tmp/bcompare.rpm "https://www.scootersoftware.com/files/bcompare-5.1.7.31736.x86_64.rpm" && \
319
- sudo yum install -y /tmp/bcompare.rpm && \
320
- rm -f /tmp/bcompare.rpm
321
- ```
322
-
323
- The `-y` flag automatically confirms package installation without prompts.
324
-
325
- **Note**: Installing the .rpm package automatically adds the Scooter Software repository to your system for future updates.
326
-
327
- #### Preventing Automatic Repository Addition
328
-
329
- If you do not want the Scooter Software repository added to your system:
330
-
331
- ```bash
332
- sudo touch /etc/default/bcompare
333
- wget -q -O /tmp/bcompare.rpm "https://www.scootersoftware.com/files/bcompare-5.1.7.31736.x86_64.rpm" && \
334
- sudo dnf install -y /tmp/bcompare.rpm && \
335
- rm -f /tmp/bcompare.rpm
336
- ```
337
-
338
- #### Verification
339
-
340
- Confirm the installation succeeded:
341
-
342
- ```bash
343
- bcompare --version
344
- ```
345
-
346
- Expected output (version numbers may vary):
347
-
348
- ```
349
- Beyond Compare Version 5.1.7 (build 31736)
350
- ```
351
-
352
- Alternatively, verify the package is installed:
353
-
354
- ```bash
355
- rpm -qa | grep bcompare
356
- ```
357
-
358
- #### Troubleshooting
359
-
360
- **Problem**: `wget: command not found`
361
-
362
- **Solution**: Install wget first:
363
-
364
- ```bash
365
- sudo dnf install -y wget
366
- # or for AL2/RHEL7:
367
- sudo yum install -y wget
368
- ```
369
-
370
- **Problem**: Dependency errors mentioning GTK or display libraries
371
-
372
- **Solution**: Install required GUI dependencies:
373
-
374
- ```bash
375
- sudo dnf groupinstall -y "Server with GUI"
376
- # or for minimal install:
377
- sudo dnf install -y gtk3 libXScrnSaver
378
- ```
379
-
380
- **Problem**: Beyond Compare fails to start on headless server
381
-
382
- **Solution**: Beyond Compare requires X11. For remote access, use X11 forwarding:
383
-
384
- ```bash
385
- ssh -X user@host
386
- bcompare
387
- ```
388
-
389
- Or install a desktop environment and use VNC/RDP.
390
-
391
- ---
392
-
393
- ### Windows (Chocolatey)
394
-
395
- #### Prerequisites
396
-
397
- - Windows 10 or Windows 11 (64-bit)
398
- - Chocolatey package manager installed
399
- - Administrator PowerShell or Command Prompt
400
-
401
- If Chocolatey is not installed, install it first by running this command in an Administrator PowerShell:
402
-
403
- ```powershell
404
- Set-ExecutionPolicy Bypass -Scope Process -Force; [System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072; iex ((New-Object System.Net.WebClient).DownloadString('https://community.chocolatey.org/install.ps1'))
405
- ```
406
-
407
- #### Installation Steps
408
-
409
- Run the following command in an Administrator PowerShell or Command Prompt:
410
-
411
- ```powershell
412
- choco install beyondcompare -y
413
- ```
414
-
415
- The `-y` flag automatically confirms all prompts, enabling fully non-interactive installation.
416
-
417
- **Note**: The Chocolatey package automatically detects your system locale and installs the appropriate language version (English, German, French, Japanese, or Chinese).
418
-
419
- #### Installation Parameters
420
-
421
- For customized installation, use these optional parameters:
422
-
423
- ```powershell
424
- choco install beyondcompare -y --params="'/CurrentUser'"
425
- ```
426
-
427
- Available parameters:
428
- - `/CurrentUser` - Install for current user only (default installs for all users)
429
- - `/LCID:nnn` - Force specific language (e.g., `/LCID:1031` for German)
430
-
431
- #### Verification
432
-
433
- Open a new Command Prompt or PowerShell window (required for PATH to update), then run:
434
-
435
- ```powershell
436
- bcompare --version
437
- ```
438
-
439
- Expected output (version numbers may vary):
440
-
441
- ```
442
- Beyond Compare Version 5.1.7 (build 31736)
443
- ```
444
-
445
- Verify the application is installed:
446
-
447
- ```powershell
448
- Get-Command bcompare
449
- ```
450
-
451
- #### Troubleshooting
452
-
453
- **Problem**: `bcompare: The term 'bcompare' is not recognized`
454
-
455
- **Solution**: Open a new terminal window. The PATH is updated during installation but existing windows do not reflect this. Alternatively, refresh the environment:
456
-
457
- ```powershell
458
- refreshenv
459
- ```
460
-
461
- **Problem**: Installation fails with access denied
462
-
463
- **Solution**: Ensure you are running PowerShell or Command Prompt as Administrator. Right-click and select "Run as administrator".
464
-
465
- **Problem**: Chocolatey command not found
466
-
467
- **Solution**: Chocolatey may not be in PATH. Close all terminal windows, open a new Administrator PowerShell, and try again.
468
-
469
- ---
470
-
471
- ### WSL (Ubuntu)
472
-
473
- #### Prerequisites
474
-
475
- - Windows Subsystem for Linux with Ubuntu installed
476
- - WSL 2 recommended for best performance
477
- - X Server running on Windows (for GUI support) or WSLg enabled (Windows 11)
478
- - sudo privileges within WSL
479
-
480
- **Important**: Beyond Compare is a GUI application. WSL requires an X server or WSLg to display graphical applications.
481
-
482
- #### Installation Steps
483
-
484
- WSL Ubuntu follows the same installation process as native Ubuntu:
485
-
486
- ```bash
487
- wget -q -O /tmp/bcompare.deb "https://www.scootersoftware.com/files/bcompare-5.1.7.31736_amd64.deb" && \
488
- sudo DEBIAN_FRONTEND=noninteractive apt-get update -y && \
489
- sudo DEBIAN_FRONTEND=noninteractive apt-get install -y /tmp/bcompare.deb && \
490
- rm -f /tmp/bcompare.deb
491
- ```
492
-
493
- #### Setting Up GUI Support
494
-
495
- **For Windows 11 with WSLg (built-in GUI support):**
496
-
497
- WSLg is enabled by default. No additional setup is required.
498
-
499
- **For Windows 10 (requires X Server):**
500
-
501
- Install an X server on Windows such as VcXsrv or X410, then configure the DISPLAY variable:
502
-
503
- ```bash
504
- export DISPLAY=$(cat /etc/resolv.conf | grep nameserver | awk '{print $2}'):0
505
- ```
506
-
507
- Add this line to `~/.bashrc` for persistence.
508
-
509
- #### Verification
510
-
511
- Confirm the installation succeeded:
512
-
513
- ```bash
514
- bcompare --version
515
- ```
516
-
517
- Expected output (version numbers may vary):
518
-
519
- ```
520
- Beyond Compare Version 5.1.7 (build 31736)
521
- ```
522
-
523
- Test launching the GUI (requires X server or WSLg):
524
-
525
- ```bash
526
- bcompare &
527
- ```
528
-
529
- #### Troubleshooting
530
-
531
- **Problem**: `cannot open display` error when launching Beyond Compare
532
-
533
- **Solution**: For Windows 11, ensure WSL is updated:
534
-
535
- ```bash
536
- wsl --update
537
- ```
538
-
539
- For Windows 10, ensure your X server is running and the DISPLAY variable is set correctly.
540
-
541
- **Problem**: Graphics appear garbled or slow
542
-
543
- **Solution**: WSLg provides better performance than external X servers. If on Windows 10, consider upgrading to Windows 11 or using VcXsrv with GPU acceleration disabled.
544
-
545
- **Problem**: Beyond Compare hangs on startup
546
-
547
- **Solution**: Reset WSL:
548
-
549
- ```bash
550
- wsl --shutdown
551
- ```
552
-
553
- Then restart your WSL terminal.
554
-
555
- ---
556
-
557
- ### Git Bash (Manual/Portable)
558
-
559
- #### Prerequisites
560
-
561
- - Windows 10 or Windows 11 (64-bit)
562
- - Git Bash installed (comes with Git for Windows)
563
- - Beyond Compare installed on Windows (see Windows section above)
564
-
565
- **Note**: Git Bash on Windows does not require a separate Beyond Compare installation. Git Bash inherits the Windows PATH, so once Beyond Compare is installed on Windows via Chocolatey or the official installer, it is automatically available in Git Bash.
566
-
567
- #### Installation Steps
568
-
569
- If Beyond Compare is already installed on Windows, it should be available in Git Bash. To install from Git Bash using Chocolatey (if Chocolatey is installed on Windows):
570
-
571
- ```bash
572
- /c/ProgramData/chocolatey/bin/choco.exe install beyondcompare -y
573
- ```
574
-
575
- Alternatively, download and run the installer silently:
576
-
577
- ```bash
578
- curl -L -o /tmp/BCompare.exe "https://www.scootersoftware.com/files/BCompare-5.1.7.31736.exe" && \
579
- /tmp/BCompare.exe /VERYSILENT /NORESTART /ALLUSERS /SUPPRESSMSGBOXES
580
- ```
581
-
582
- The installer switches ensure completely silent installation:
583
- - `/VERYSILENT` - No UI shown during installation
584
- - `/NORESTART` - Do not restart computer after installation
585
- - `/ALLUSERS` - Install for all users
586
- - `/SUPPRESSMSGBOXES` - Suppress all message boxes
587
-
588
- After installation, close and reopen Git Bash for PATH changes to take effect.
589
-
590
- #### Verification
591
-
592
- Confirm Beyond Compare is accessible from Git Bash:
593
-
594
- ```bash
595
- bcompare --version
596
- ```
597
-
598
- Expected output (version numbers may vary):
599
-
600
- ```
601
- Beyond Compare Version 5.1.7 (build 31736)
602
- ```
603
-
604
- Verify the executable path:
605
-
606
- ```bash
607
- which bcompare
608
- ```
609
-
610
- Expected output:
611
-
612
- ```
613
- /c/Program Files/Beyond Compare 5/bcompare
614
- ```
615
-
616
- #### Configuring Git to Use Beyond Compare
617
-
618
- Beyond Compare integrates well with Git as a diff and merge tool. Configure Git to use it:
619
-
620
- ```bash
621
- git config --global diff.tool bc
622
- git config --global difftool.bc.path "/c/Program Files/Beyond Compare 5/bcomp.exe"
623
- git config --global difftool.prompt false
624
-
625
- git config --global merge.tool bc
626
- git config --global mergetool.bc.path "/c/Program Files/Beyond Compare 5/bcomp.exe"
627
- git config --global mergetool.bc.trustExitCode true
628
- ```
629
-
630
- Test the configuration:
631
-
632
- ```bash
633
- git difftool HEAD~1
634
- ```
635
-
636
- #### Troubleshooting
637
-
638
- **Problem**: `bcompare: command not found` in Git Bash
639
-
640
- **Solution**: The Windows PATH may not be fully inherited. Add the Beyond Compare directory explicitly to your `~/.bashrc`:
641
-
642
- ```bash
643
- export PATH="$PATH:/c/Program Files/Beyond Compare 5"
644
- ```
645
-
646
- **Problem**: Git difftool shows path errors
647
-
648
- **Solution**: Use Windows-style paths in Git configuration or escape spaces properly:
649
-
650
- ```bash
651
- git config --global difftool.bc.path "C:/Program Files/Beyond Compare 5/bcomp.exe"
652
- ```
653
-
654
- **Problem**: Silent installer exits but Beyond Compare is not installed
655
-
656
- **Solution**: The silent installer requires Administrator privileges. Open Git Bash as Administrator by right-clicking on the shortcut and selecting "Run as administrator".
657
-
658
- ---
659
-
660
- ## Post-Installation Configuration
661
-
662
- After installing Beyond Compare on any platform, you may want to configure several optional features.
663
-
664
- ### Registering Your License
665
-
666
- Beyond Compare includes a 30-day trial. To register a purchased license:
667
-
668
- 1. Open Beyond Compare
669
- 2. Go to **Help > Enter Key** (Windows/Linux) or **Beyond Compare > Enter Key** (macOS)
670
- 3. Enter your license key
671
-
672
- For silent registration during deployment, create a license file. Refer to Scooter Software's Network Setup guide for enterprise deployment options.
673
-
674
- ### Configuring as Default Diff/Merge Tool
675
-
676
- #### For Git (All Platforms)
677
-
678
- Configure Git to use Beyond Compare for diffs and merges:
679
-
680
- ```bash
681
- # Set Beyond Compare as diff tool
682
- git config --global diff.tool bc
683
- git config --global difftool.prompt false
684
-
685
- # Set Beyond Compare as merge tool
686
- git config --global merge.tool bc
687
- git config --global mergetool.bc.trustExitCode true
688
- ```
689
-
690
- Usage:
691
- - `git difftool` - View diff in Beyond Compare
692
- - `git mergetool` - Resolve merge conflicts in Beyond Compare
693
-
694
- #### For SVN
695
-
696
- Beyond Compare can be configured as the external diff tool for Subversion. Add to your SVN config file (`~/.subversion/config` on Unix, `%APPDATA%\Subversion\config` on Windows):
697
-
698
- ```ini
699
- [helpers]
700
- diff-cmd = /path/to/bcomp
701
- ```
702
-
703
- ### Session File Defaults
704
-
705
- Beyond Compare uses sessions to save comparison configurations. Default session locations:
706
-
707
- - **Windows**: `%APPDATA%\Scooter Software\Beyond Compare 5\`
708
- - **macOS**: `~/Library/Application Support/Beyond Compare 5/`
709
- - **Linux**: `~/.config/bcompare5/`
710
-
711
- ---
712
-
713
- ## Common Issues
714
-
715
- ### Issue: Beyond Compare Runs Slowly with Large Files
716
-
717
- **Symptoms**: UI becomes unresponsive when comparing very large files or directories with many files.
718
-
719
- **Solution**: Adjust comparison settings:
720
-
721
- 1. Go to **Tools > Options > Comparison**
722
- 2. Enable "Quick compare" option for large directory comparisons
723
- 3. Disable "Compare contents" for initial scans
724
- 4. Increase memory allocation if available in options
725
-
726
- ### Issue: Character Encoding Problems
727
-
728
- **Symptoms**: Special characters display incorrectly, or files show as entirely different when they are not.
729
-
730
- **Solution**: Set the correct encoding:
731
-
732
- 1. Open the file comparison
733
- 2. Go to **Format > Encoding**
734
- 3. Select the correct encoding (UTF-8 is recommended for most cases)
735
-
736
- ### Issue: Line Ending Differences Flagged as Changes
737
-
738
- **Symptoms**: Files appear different due to Windows (CRLF) vs Unix (LF) line endings.
739
-
740
- **Solution**: Configure Beyond Compare to ignore line ending differences:
741
-
742
- 1. Go to **Session > Session Settings**
743
- 2. Under "Misc" tab, check "Ignore line endings"
744
-
745
- ### Issue: Network/Cloud Storage Access Fails
746
-
747
- **Symptoms**: Unable to connect to FTP, SFTP, or cloud storage locations.
748
-
749
- **Solution**: Verify network connectivity and credentials. For FTP/SFTP:
750
-
751
- 1. Go to **Tools > Options > FTP**
752
- 2. Verify proxy settings if behind a corporate firewall
753
- 3. Check that the server address and port are correct
754
-
755
- ### Issue: Beyond Compare Not Found After Installation
756
-
757
- **Symptoms**: Terminal cannot find `bcompare` command after installation.
758
-
759
- **Solution**: The installation path may not be in your system PATH. Verify installation location and add to PATH:
760
-
761
- **Linux**:
762
- ```bash
763
- export PATH="$PATH:/usr/bin"
764
- ```
765
-
766
- **Windows** (PowerShell):
767
- ```powershell
768
- $env:PATH += ";C:\Program Files\Beyond Compare 5"
769
- ```
770
-
771
- ---
772
-
773
- ## Uninstallation
774
-
775
- ### macOS
776
-
777
- ```bash
778
- brew uninstall --cask beyond-compare
779
- ```
780
-
781
- ### Ubuntu/Debian
782
-
783
- ```bash
784
- sudo apt remove -y bcompare
785
- ```
786
-
787
- ### Amazon Linux/RHEL
788
-
789
- ```bash
790
- sudo dnf remove -y bcompare
791
- # or for AL2/RHEL7:
792
- sudo yum remove -y bcompare
793
- ```
794
-
795
- ### Windows
796
-
797
- ```powershell
798
- choco uninstall beyondcompare -y
799
- ```
800
-
801
- ---
802
-
803
- ## References
804
-
805
- - [Scooter Software Official Website](https://www.scootersoftware.com/)
806
- - [Beyond Compare Download Page](https://www.scootersoftware.com/download)
807
- - [Beyond Compare Linux Installation Guide](https://www.scootersoftware.com/kb/linux_install)
808
- - [Beyond Compare macOS Command Line Tools](https://www.scootersoftware.com/support.php?zz=kb_OSXInstallCLT)
809
- - [Beyond Compare Homebrew Cask](https://formulae.brew.sh/cask/beyond-compare)
810
- - [Beyond Compare Chocolatey Package](https://community.chocolatey.org/packages/beyondcompare)
811
- - [Beyond Compare Version Control Integration](https://www.scootersoftware.com/support.php?zz=kb_vcs)
812
- - [Beyond Compare Command Line Reference](https://www.scootersoftware.com/v4help/command_line_reference.html)
813
- - [Scooter Software Forums](https://forum.scootersoftware.com/)