The openwrt.melmac.net packages documentation

This is documentation for packages for OpenWrt devices created/maintained under the Melmac Open Source Software Development Foundation (MOSSDeF). While some of these are packages are already available from official OpenWrt release/snapshots repositories/feeds, the ipk packages repo/the apk packages repo usually contain newer versions. You can also browse/check-out the source code.

How to use

On your OpenWrt device

On your OpenWrt device with opkg

The ipk binaries repository is currently hosted at GitHub. If you have problems accessing my ipk packages repo or access to GitHub may be blocked at the location where your router is installed, skip to the Add OPKG/IPK repository to your OpenWrt device (jsDelivr) section. Both repositories use HTTPS protocol and require one of the SSL support packages to be installed on your router.

Add OPKG/IPK repository to your OpenWrt device (GitHub)
opkg update
opkg install wget-ssl
echo -e -n 'untrusted comment: OpenWrt usign key of Stan Grishin\nRWR//HUXxMwMVnx7fESOKO7x8XoW4/dRidJPjt91hAAU2L59mYvHy0Fa\n' > /etc/opkg/keys/7ffc7517c4cc0c56
sed -i '/stangri_repo/d' /etc/opkg/customfeeds.conf
echo 'src/gz stangri_repo https://repo.openwrt.melmac.net' >> /etc/opkg/customfeeds.conf
opkg update
Add OPKG/IPK repository to your OpenWrt device (jsDelivr)
opkg update
opkg install wget-ssl
echo -e -n 'untrusted comment: OpenWrt usign key of Stan Grishin\\nRWR//HUXxMwMVnx7fESOKO7x8XoW4/dRidJPjt91hAAU2L59mYvHy0Fa\\n' > /etc/opkg/keys/7ffc7517c4cc0c56
sed -i '/stangri_repo/d' /etc/opkg/customfeeds.conf
echo 'src/gz stangri_repo https://cdn.jsdelivr.net/gh/stangri/repo.openwrt.melmac.net' >> /etc/opkg/customfeeds.conf
opkg update

Please note that there may be delay in jsDelivr CDN cache updates comparing to my packages repo at GitHub which may cause opkg to pull older files and/or complain about wrong signature.

On your OpenWrt device with apk

The apk binaries repository is currently hosted at GitHub. If you have problems accessing my apk packages repo or access to GitHub may be blocked at the location where your router is installed, skip to the Add APK repository to your OpenWrt device (jsDelivr) section. Both repositories use HTTPS protocol and require one of the SSL support packages to be installed on your router.

Add APK repository to your OpenWrt device (GitHub)
echo 'https://apk.openwrt.melmac.net/packages.adb' > /etc/apk/repositories.d/apk.openwrt.melmac.net.list
wget https://apk.openwrt.melmac.net/apk.openwrt.melmac.net.pem -O /etc/apk/keys/apk.openwrt.melmac.net.pem
apk update
Add APK repository to your OpenWrt device (jsDelivr)
echo 'https://cdn.jsdelivr.net/gh/stangri/apk.openwrt.melmac.net/packages.adb' > /etc/apk/repositories.d/apk.openwrt.melmac.net.list
wget https://apk.openwrt.melmac.net/apk.openwrt.melmac.net.pem -O /etc/apk/keys/apk.openwrt.melmac.net.pem
apk update

Please note that there may be delay in jsDelivr CDN cache updates comparing to my apk packages repo at GitHub which may cause apk to pull older files and/or complain about wrong signature.

Image Builder

Image Builder with opkg

The ipk binaries repository is currently hosted at GitHub. If you have problems accessing my ipk packages repo or access to GitHub may be blocked at the location where your router is installed, skip to the Add OPKG/IPK repository to Image Builder (jsDelivr) section.

Add OPKG/IPK repository to Image Builder (GitHub)

Add the following line:

src/gz stangri_repo https://repo.openwrt.melmac.net

to the repositories.conf file inside your Image Builder directory. You can use the following shell script code to achieve that:

sed -i '/stangri_repo/d' repositories.conf
sed -i '4 i\src/gz stangri_repo https://repo.openwrt.melmac.net' repositories.conf
Add OPKG/IPK repository to Image Builder (jsDelivr)

Add the following line:

src/gz stangri_repo https://cdn.jsdelivr.net/gh/stangri/repo.openwrt.melmac.net

to the repositories.conf file inside your Image Builder directory. You can use the following shell script code to achieve that:

sed -i '/stangri_repo/d' repositories.conf
sed -i '4 i\src/gz stangri_repo https://cdn.jsdelivr.net/gh/stangri/repo.openwrt.melmac.net' repositories.conf

Image Builder with apk

The apk binaries repository is currently hosted at GitHub. If you have problems accessing my apk packages repo or access to GitHub may be blocked at the location where your router is installed, skip to the Add APK repository to Image Builder (jsDelivr) section.

Add APK repository to Image Builder (GitHub)

Add the following line:

https://apk.openwrt.melmac.net/packages.adb

to the repositories file inside your Image Builder directory. You can use the following shell script code to achieve that:

sed -i '/apk.openwrt.melmac.net/d' repositories
echo 'https://apk.openwrt.melmac.net/packages.adb' >> repositories
Add APK repository to Image Builder (jsDelivr)

Add the following line:

https://cdn.jsdelivr.net/gh/stangri/apk.openwrt.melmac.net/packages.adb

to the repositories file inside your Image Builder directory. You can use the following shell script code to achieve that:

sed -i '/apk.openwrt.melmac.net/d' repositories
echo 'https://cdn.jsdelivr.net/gh/stangri/apk.openwrt.melmac.net/packages.adb' >> repositories

SDK

The packages source code is available in my packages source on GitHub/jsDelivr. Individual packages are also available in their own repositories at GitHub. Check out the code for the individual packages you want into your SDK’s package folder or for luci apps into the package/luci/applications folder.

Description of packages

adblock-fast & luci-app-adblock-fast

This service provides lightweight and very fast dnsmasq-based ad blocking. Please see the README at GitHub/jsDelivr and OpenWrt Forum Thread for further information. This package is an improved version of simple-adblock.

https-dns-proxy & luci-app-https-dns-proxy

This is a lean RFC8484-compatible DNS-over-HTTPS (DoH) proxy service which supports DoH servers ran by AdGuard, CleanBrowsing, Cloudflare, Google, ODVR (nic.cz) and Quad9. Please see the README at GitHub/jsDelivr for further information.

luci-app-advanced-reboot

This package enables Web UI for reboot to another partition functionality on supported (dual-partition) routers and to power off (power down) your router. Please see the README at GitHub/jsDelivr and OpenWrt Forum Thread for further information.

netclient

Netclient is an automated WireGuard Management Client. Netclient is a client application for the Netmaker networks. Netclient is developed by Gravitl. Please see the README at GitHub/jsDelivr and OpenWrt Forum Thread for further information.

pbr & luci-app-pbr

This service can be used to enable policy-based routing for WAN/WAN6 interfaces and multiple VPN tunnels. Supported VPN protocols include: L2TP, Openconnect, OpenVPN, Softether and Wireguard. Policies can be based on domain names, IP addresses, ports or any combination of the above. This service supports policies for both outgoing and incoming traffic to target specific interfaces/tunnels. Please see the README at GitHub/jsDelivr and OpenWrt Forum Thread for further information.

Description of outdated/obsolete packages

antminer-monitor

This service can be used to monitor local BITMAIN Antminers. This is just the wrapper for Antminer Monitor python app. WARNING: Requires a router with a lot of flash, 128Mb recommended. Please see the README at GitHub/jsDelivr for further information.

fakeinternet & luci-app-fakeinternet

This service can be used to fake internet connectivity for local devices. Can be used on routers with no internet access to suppress warnings on local devices on no internet connectivity. Please see the README at GitHub/jsDelivr and OpenWrt Forum Thread for further information.

libcurl with HTTP/3 and QUIC support

Instructions for building libcurl with HTTP/3 and QUIC support using out of the tree OpenSSL-QuicTLS can be found on GitHub/jsDelivr

luci-app-easyflash

This package installs Web UI for quickly updating your router firmware if you use automated snapshots build process which produces fully customized images and uploads them to your router. Requires sysupgrade-compatible upgrade file /tmp/firmware.img and a one-line description (target/version/filename info) in /tmp/firmware.tag. WARNING: does not keep your router settings.

luci-mod-alt-reboot

This package enables Web UI for reboot to another partition functionality on supported (dual-partition) routers and to power off (power down) your router by overwriting default System –> Reboot page. Please see the README at GitHub/jsDelivr for further information. This package has been superseded by luci-app-advanced-reboot and is no longer developed/supported.

luci-theme-material-old

This package brings back the old button styles to the luci-theme-material on OpenWrt 18.06.0-rc2 and later. Please see the README at GitHub/jsDelivr for further information.

nebula

Nebula is a scalable overlay networking tool with a focus on performance, simplicity and security. It lets you seamlessly connect computers anywhere in the world. Nebula is being developed by Slack. Please see the README at GitHub/jsDelivr and OpenWrt Forum Thread for further information.

simple-adblock & luci-app-simple-adblock

This service provides lightweight and very fast dnsmasq-based ad blocking. Please see the README at GitHub/jsDelivr and OpenWrt Forum Thread for further information. This package has been obsoleted by adblock-fast.

slider-support

This package enables switching between Router, Access Point and Wireless Repeater modes of operation for supported routers equipped with slider switch. It also sets the correct current mode setting for the WLAN Blinker service (README at GitHub/jsDelivr). Please see the README at GitHub/jsDelivr for further information.

vpnbypass & luci-app-vpnbypass

This service can be used to enable split tunneling for outgoing traffic for a single OpenVPN tunnel used as the default gateway. Supports accessing domains, IP ranges outside of your OpenVPN tunnel (bypassing OpenVPN tunnel) over IPv4. Please see the README at GitHub/jsDelivr and OpenWrt Forum Thread for further information. This package has been obsoleted by pbr.

vpn-policy-routing & luci-app-vpn-policy-routing

This service can be used to enable policy-based routing for WAN/WAN6 interfaces and multiple VPN tunnels. Supported VPN protocols include: L2TP, Openconnect, OpenVPN and Wireguard. Policies can be based on domain names, IP addresses, ports or any combination of the above. This service supports policies for both outgoing and incoming traffic to target specific interfaces/tunnels. Please see the README at GitHub/jsDelivr and OpenWrt Forum Thread for further information. This package has been obsoleted by pbr.

wlanblinker & luci-app-wlanblinker

This service can be used to indicate WLAN status by blinking the unused LED. Please see the README at GitHub/jsDelivr for further information.

wireshark-helper & luci-app-wireshark-helper

This service can be used to configure router to sniff packets to/from monitored device on the device running Wireshark app. Please see the README at GitHub/jsDelivr for further information.

About MOSSDeF

MOSSDeF, fighting global warming by creating cool software since 2004.