|Project Name||Stars||Downloads||Repos Using This||Packages Using This||Most Recent Commit||Total Releases||Latest Release||Open Issues||License||Language|
|Asuswrt Merlin.ng||4,763||8 days ago||55||other|
|Third party firmware for Asus routers (newer codebase)|
|Openwrtinvasion||1,063||6 months ago||1||Lua|
|Root shell exploit for several Xiaomi routers: 4A Gigabit, 4A 100M, 4, 4C, 3Gv2, 4Q, miWifi 3C...|
|Asuswrt Merlin.ng||954||2 days ago||164|
|Extends the support of Asus Merlin firmware to more routers|
|Nmrpflash||708||11 days ago||13||gpl-3.0||C|
|Netgear Unbrick Utility|
|Gargoyle||441||2 months ago||31||C|
|Gargoyle Router Management Utility|
|Asus Cmd||238||9 years ago||2||C|
|ASUS Router infosvr UDP Broadcast root Command Execution|
|Asuswrt Xiaomi||166||a year ago||other|
|AsusWRT for Xiaomi routers|
|Yourfritz||148||5 months ago||4||gpl-2.0||Shell|
|dynamic package management for AVM routers|
|Mcwrt||142||2 years ago||C|
|A OpenWRT project for the Linksys WRT1900AC router|
|Amtm||137||2 months ago||gpl-3.0||Shell|
|amtm - the Asuswrt-Merlin Terminal Menu|
Gargoyle is a third party firmware for routers based on the Openwrt firmware. It can be described at a high level as a front-end to Openwrt, however there are several packages and custom kernel modules which are not included upstream in Openwrt. As a result, Gargoyle cannot be installed as a set-of-packages to an existing Openwrt installation, and is a separate firmware as far as installation is concerned. Gargoyle is open-source software, and aims to be the first open-source firmware project to place a strong focus on creating a user-friendly interface.
As a developer, or even a casual contributor, you should start here at the Gargoyle wiki developer documentation. You should always consult the wiki for up to date information on getting started (as it is maintained by the community, and this readme may not receive as much attention), however as a brief summary...
The following prerequisites assume a 64bit Ubuntu system. Many devs use virtual machines, and they are perfectly fine for this kind of work.
sudo apt-get install build-essential asciidoc binutils bzip2 gawk gettext git libncurses5-dev libz-dev patch unzip zlib1g-dev lib32gcc1 libc6-dev-i386 subversion flex uglifyjs \ git-core gcc-multilib p7zip p7zip-full msmtp libssl-dev texinfo npm libelf-dev clang flex bison g++ g++-multilib python3-distutils rsync file wget
NOTE Python is also required and needs to be in your path. Python 3 is recommended. For Ubuntu users, it is recommended to install
python-is-python3 to solve this issue automatically.
You've already found it if you're reading this, but lets get it on your local machine. Choose one of the following commands depending on whether you want to use SSH or HTTPS authentication:
[email protected]:ericpaulbishop/gargoyle.git https://github.com/ericpaulbishop/gargoyle.git
After building is complete, you'll have
make ar71xx FULL_BUILD=true
make ar71xx.usb_large FULL_BUILD=true
See the wiki for more detailed instructions.
Please see the relevant Openwrt wiki or ToH entries for your device for the intricacies of installation, upgrading and failsafe for your device.
The forums: Gargoyle-Router Forums
Please read CONTRIBUTING.md for details on our code of conduct, and the process for submitting pull requests to us.
If you have discovered a genuine bug or other shortcoming in the firmware that you would like addressed, please first check the forums to see if it has already been raised and addressed. If the community is not able to address it for you, or the consensus is that it is a genuine bug, please raise an issue in GitHub. NOTE Issues are not the place for feature requests. Please keep these to the forum. Include as much detail as you can, such as:
Gargoyle is copyright (C) 2008-2019 by Eric Bishop Gargoyle is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License version 2.0 as published by the Free Software Foundation, with the following clarificaiton/exception that permits adpating the program to configure proprietary "back end" software provided that all modifications to the web interface portion remain covered by this license:
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.