MW Icon MacWave Text MacWave Logo

A package manager for macOS software developers.

Latest Version : 2.2.0 Release on 2026-09-22
View On GitHub
Explore MacWave Team
(Click to view)

What is MacWave?

MacWave is a package manager that runs on macOS/Linux, designed to host common software packages for macOS software developers.

Why MacWave

Supported macOS Version

macOS Sonoma 14 and above

Install MacWave

In the terminal, run:

$ /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Sha0huaZhang/MacWave/2.2.0/lib/install.sh)"
$ source ~/.zshrc

(If you are using bash instead of zsh, run source ~/.bashrc)

Requirements: Python (3.13 and above), Xcode Command Line Tools (14.0 and above).

Uninstall MacWave

To completely remove MacWave from your system, run the following command in your terminal:

$ /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Sha0huaZhang/MacWave/2.2.0/lib/uninstall.sh)"

Download Directory

Installed binaries are stored in:

1. ~/.local/macwave
2. /opt/macwave
3. /usr/local/macwave (Only Intel Mac)
4. Custom

Config file is stored in:

/opt/macwave_config

Run Packages

To run a package, run the following commands in your terminal:

{package_name}@{version}

Notes: DO NOT forget the version number, or you CAN NOT run the package

Command Reference

Usage:
  wave <command> [package] [flags]

Commands:
  install     Install a package (Latest Version)
  uninstall   Uninstall a package
  list        List installed packages
  search      Search for a package in the index
  info        Display detailed information about a package

Flags:
  -h, --help              Show help for any command
  -V, --version           Print version information
  -v, --verbose           Enable verbose output (show detailed logs)

Global Flags (can be used with any command):
  -C, --continue          Resume interrupted downloads (like curl -C -)
      --proxy string      Specify an HTTP/HTTPS proxy (e.g., http://127.0.0.1:8080)
      --skip-ssl          Skip SSL certificate verification (insecure)
      --limit-rate string Limit download speed (e.g., 200K, 1M, 5M)
      --ver string        Install a specific version of the package

Special Flags:
wave install <pkgname>@<version>   Download certain version(s) of a package

Demo Pictures

demo1

demo2

demo3

Supported Packages

(Listed in alphabetical order)

choma         by opa334
jq            by Stephen Dolan, Nicolas Williams, et al.
ldid          by Jay Freeman (saurik) / Procursus Team
trollrestore  by JJTech (@JJTech0130)
wget          by GNU Project
ffmpeg        by FFmpeg Team
            

License

This project is licensed under the MIT License.

Contact Us

GitHub @Sha0huaZhang
Click the links to open.

1. Users should carefully read the agreement and possible negative impacts before operation, and bear the consequences themselves. Using MacWave means that you have agreed to the above conditions. MacWave is not responsible for any losses caused to users by MacWave or its software packages.

2. MacWave (especially beta versions) may affect users due to code defects, security issues, etc. Users should be aware of and accept this risk, otherwise please do not use it. MacWave is not responsible for any losses caused to users' devices, etc.

3. MacWave only provides links to software packages, not the software packages themselves. MacWave is not responsible for any losses caused to users due to security vulnerabilities, malicious code, etc. of the software packages themselves. If users violate the software package agreement, MacWave is not responsible.

4. The software packages distributed by MacWave are for legitimate purposes such as learning and research only. They are prohibited for cracking, attacks, or other illegal activities. If losses are caused by improper use, MacWave is not responsible.

5. This agreement may be updated. If there is an update and you do not agree to the updated agreement, please delete MacWave. For deletion methods, please refer to the official website or official tutorial.

6. Please be sure to download the official software from the MacWave official website. If users download MacWave software from unofficial sources and suffer losses, MacWave is not responsible.

7. Users should read all agreements in full and agree before using MacWave and its software packages. Otherwise, please do not use MacWave and its software packages.

8. MacWave is completely free. Please do not trust any individuals or claims stating that MacWave charges a fee. If you suffer losses as a result, MacWave is not responsible.

9. MacWave does not sell any products. Any messages or posts about paid MacWave products are counterfeit. Any individuals or platforms selling MacWave are unofficial. MacWave is not responsible for any losses caused by this.

10. MacWave does not produce any physical products. Any physical products (such as books, comics, etc.) claiming to be related to MacWave are counterfeit. MacWave is not responsible for any losses caused by this.

11. MacWave only produces code, not unrelated products. Any e-books, audio-visual works, etc. claiming to be related to MacWave are counterfeit. MacWave is not responsible for any losses caused by this.

12. MacWave's consultation and feedback channels are completely free, and all feedback is processed equally in order. Any individuals or organizations claiming priority access to consultation or replies, especially those charging fees, are unofficial. MacWave is not responsible for any losses caused by this.

13. MacWave does not use subscriptions, one-time purchases, or in-app purchases. Any individuals or organizations claiming to help obtain in-app purchases, especially those charging fees, are unofficial. MacWave is not responsible for any losses caused by this.

14. MacWave's source code is fully open. Any individuals or organizations claiming to provide core code, especially those charging fees, are unofficial. MacWave is not responsible for any losses caused by this.

15. MacWave does not use a membership system. Any individuals or organizations claiming to offer memberships, especially those charging fees, are unofficial. MacWave is not responsible for any losses caused by this.

16. MacWave has only one version, and it is publicly available. There are no "Personal Edition", "Enterprise Edition", "Custom Edition", or similar variants. Any such claims are counterfeit. MacWave is not responsible for any losses caused by this.

17. The only official website is https://macwave.org. Any other websites are not official. MacWave is not responsible for any losses caused by this.

18. Using MacWave does not require registration, nor does it require activation codes, etc. Any individuals or organizations claiming to help register MacWave accounts, provide MacWave accounts, activation codes, etc., especially those charging fees, are unofficial. MacWave is not responsible for any losses caused by this.

19. Downloading MacWave may consume network data. Users should be aware of this and handle it properly. MacWave is not responsible for any losses caused by this.

20. Contacting MacWave official support or sending emails may consume network data. Users should be aware of this and handle it properly. MacWave is not responsible for any losses caused by this.

21. Official accounts are only registered on Twitter (X) and GitHub. Any accounts on other platforms are counterfeit. MacWave is not responsible for any losses caused by this.

22. The only official feedback email address is hi@macwave.org, but replies will be sent from trollresignertest1@outlook.com. Please do not send messages directly to trollresignertest1@outlook.com, and do not wait for reply emails from hi@macwave.org. Do not trust other email addresses claimed by others or organizations as official, and do not treat replies from other emails as official replies. MacWave is not responsible for any losses caused by this.

23. Users should use MacWave and its software packages in accordance with official guidelines. MacWave is not responsible for any losses caused by not following the guidelines, not reading the guidelines, or operational errors.

24. Users should download MacWave on eligible devices. For specific requirements, please refer to the official website. If losses are caused by violations, MacWave is not responsible.

25. Users should confirm their system environment, device model, etc., and verify from reliable sources (such as official documentation of other software) whether there are conflicts. If losses are caused by software conflicts, MacWave is not responsible.

26. Users are only permitted to run MacWave on their personal devices. MacWave is not responsible for any losses caused by running MacWave on others' devices, public devices, or devices without the owner's authorization.

27. MacWave is not responsible for any losses caused by running MacWave due to bugs in the operating system or virtual machine itself.

28. MacWave is not responsible for any losses caused by MacWave not running as expected due to unauthorized hardware modifications.

29. MacWave is not responsible for any losses caused by using it for unofficial purposes.

30. Private redistribution of MacWave and its software packages, modified versions, etc., is permitted, but the original author and official website must be credited, and others must be clearly informed that this version is a modified version. Distributing non-official products and software packages under descriptions such as "official version" is prohibited. Non-official versions of MacWave may also cause losses. If any of these violations cause losses, MacWave is not responsible.

31. Without the permission of the original author, you shall not misuse, reuse, register trademarks, or otherwise occupy the MacWave icon and its name, or occupy them in a way that sufficiently associates users with them.

32. MacWave is not responsible for any losses caused by incomplete downloads of executable scripts due to network fluctuations, etc.

33. MacWave is not responsible for any losses suffered by users due to force majeure.

34. MacWave has no cooperation with any company or profit-making organization. Any claims of cooperation with MacWave by companies or profit-making organizations are counterfeit. MacWave is not responsible for any losses caused by this.



1. 用户在操作前应仔细阅读协议及可能造成的负面影响,并自行承担后果,使用MacWave即视为已达成上述条件。MacWave及其软件包对使用者造成损失的,MacWave不承担责任

2. MacWave(尤其是beta版)可能由于自身代码缺陷、安全问题等对用户造成影响,用户应知悉并接受这一风险,否则请勿使用。对用户的设备等造成损失的,MacWave不承担责任

3. MacWave仅提供指向软件包的链接,不提供软件包本身。软件包因本身的安全漏洞、恶意代码等对用户造成损失的,MacWave不承担责任。用户如果违反软件包协议,MacWave不承担责任

4. MacWave分发的软件包仅供学习、研究等正当用途,禁止用于破解、攻击等行为。如果用于不正当用途造成损失,MacWave不承担责任

5. 本协议可能会有更新。如有,且你不同意更新后的协议,请删除MacWave,删除方法参见官网或官方教程

6. 请务必从MacWave官方网站下载正版软件。如果用户从非官方渠道下载的MacWave软件造成损失,MacWave不承担责任

7. 用户应完整阅读所有协议并同意后再使用MacWave及其软件包,否则请勿使用MacWave及其软件包

8. MacWave完全免费,请勿相信任何宣称MacWave收费的言论、人员等。因此蒙受损失的,MacWave不承担责任

9. MacWave不出售任何产品。任何有关MacWave收费产品的消息、帖子等均属伪造,任何出售MacWave的个人、平台等均为非官方,由此造成损失的,MacWave不承担责任

10. MacWave不产出任何实体产品。任何有关MacWave的实体产品(如书籍、漫画等)均属伪造。由此造成损失的,MacWave不承担责任

11. MacWave仅产出代码,不产出无关产品。任何有关MacWave的电子书、音像制品等均属伪造。由此造成损失的,MacWave不承担责任

12. MacWave的咨询和反馈平台完全免费,且按顺序平等处理所有反馈。任何宣称可以优先获得咨询、回复等,尤其是收取费用的的个人或组织均为非官方。由此造成损失的,MacWave不承担责任

13. MacWave不使用订阅制、买断制或内购,任何宣称可以帮忙获取内购的个人、组织等,尤其是收取费用的均为非官方。由此造成损失的,MacWave不承担责任。

14. MacWave的源代码全部公开。任何宣称可以提供核心代码的个人、组织等,尤其是收取费用的均为非官方。由此造成损失的,MacWave不承担责任。

15. MacWave不使用会员制。任何宣称可以申请会员的个人、组织等,尤其是收取费用的均为非官方。由此造成损失的,MacWave不承担责任。

16. MacWave只有一个版本,且公开。不存在"个人版""企业版""定制版"或类似内容,如有,均属伪造。由此造成损失的,MacWave不承担责任。

17. 官方唯一网址为https://macwave.org,其他网址均不是官方网址。因此造成损失的,MacWave不承担责任

18. 使用MacWave无需注册,也没有激活码等,任何宣称可以帮忙注册MacWave账号,提供MacWave账号、激活码等的个人、组织等,尤其是收取费用的均为非官方。由此造成损失的,MacWave不承担责任。

19. 下载MacWave可能会消耗网络流量,下载前须知悉并妥善处理,否则造成损失的,MacWave不承担责任

20. 向MacWave官方咨询、发送邮件等可能消耗网络流量,下载前须知悉并妥善处理,否则造成损失的,MacWave不承担责任

21. 官方账号仅在Twitter(X)、GitHub注册,其他平台如有则均为仿造。因此造成损失的,MacWave不承担责任

22. MacWave唯一反馈邮箱地址为hi@macwave.org,但回复你的邮箱地址为trollresignertest1@outlook.com。请勿直接向trollresignertest1@outlook.com发送信息,也不要等待hi@macwave.org的回复邮件。不要相信他人或组织等声称的其他邮箱地址,不要向其他邮箱视为官方邮箱发送邮件,也不要将其他邮箱的回复视为官方回复。由此造成损失的,MacWave不承担责任

23. 用户应按照官方指导使用MacWave及其软件包。对于不按照指导、不阅读指导、操作失误等原因导致损失的,MacWave不承担责任

24. 用户应在符合条件的设备下载MacWave,具体要求参见官网。如有违反导致损失,MacWave不承担责任

25. 用户应确认自己的系统环境、设备型号等信息,并从可信来源(如其他软件的官方说明等)确认是否冲突。如果由于软件冲突导致损失,MacWave不承担责任

26. 用户仅可在个人设备运行MacWave,在他人、公共设备或未经持有者授权设备运行MacWave造成损失的,MacWave不承担责任

27. 由于操作系统或虚拟机自身的Bug导致用户运行MacWave造成损失的,MacWave不承担责任

28. 由于私自改装硬件设备等原因导致MacWave未按预期运行并导致损失的,MacWave不承担责任

29. 用于非官方用途导致损失的,MacWave不承担责任

30. 允许私自分发MacWave及其软件包、修改版等,但必须注明原作者及官方网站,并明确告知其他人此版本为改版,禁止以"官方正版"等描述分发非正版产品及软件包。非官方版本可能也会造成损失。如果违反且造成损失,MacWave不承担责任

31. 未经原作者允许,不得以滥用、复用、注册商标等方式侵占MacWave图标及其名称,或以充分使用户联想、关联的方式侵占

32. 由于网络波动等原因导致软件可执行脚本下载不全并造成损失的,MacWave不承担责任

33. 由于不可抗力因素导致用户蒙受损失的,MacWave不承担责任

34. MacWave未与任何公司或营利组织等产生合作,如有公司或营利组织等声称与MacWave合作均属伪造。由此造成损失的,MacWave不承担责任