{"id":13436961,"url":"https://github.com/wb2osz/direwolf","last_synced_at":"2025-05-14T02:04:51.701Z","repository":{"id":35873540,"uuid":"40158752","full_name":"wb2osz/direwolf","owner":"wb2osz","description":"Dire Wolf is a software \"soundcard\" AX.25 packet modem/TNC and APRS encoder/decoder. It can be used stand-alone to observe APRS traffic, as a tracker, digipeater, APRStt gateway, or Internet Gateway (IGate).   For more information, look at the bottom 1/4 of this page and in https://github.com/wb2osz/direwolf/blob/dev/doc/README.md ","archived":false,"fork":false,"pushed_at":"2025-04-24T21:02:09.000Z","size":142775,"stargazers_count":1682,"open_issues_count":201,"forks_count":314,"subscribers_count":118,"default_branch":"master","last_synced_at":"2025-04-24T21:20:51.785Z","etag":null,"topics":["aprs","ax25","digipeater","ham-radio","igate","packet-radio","raspberry-pi","tnc"],"latest_commit_sha":null,"homepage":"","language":"C","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/wb2osz.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGES.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2015-08-04T02:24:27.000Z","updated_at":"2025-04-22T17:34:42.000Z","dependencies_parsed_at":"2023-02-16T03:30:46.803Z","dependency_job_id":"9125ea90-4e10-47b0-af39-abfd8da6551a","html_url":"https://github.com/wb2osz/direwolf","commit_stats":null,"previous_names":[],"tags_count":20,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wb2osz%2Fdirewolf","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wb2osz%2Fdirewolf/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wb2osz%2Fdirewolf/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wb2osz%2Fdirewolf/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/wb2osz","download_url":"https://codeload.github.com/wb2osz/direwolf/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254052668,"owners_count":22006716,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["aprs","ax25","digipeater","ham-radio","igate","packet-radio","raspberry-pi","tnc"],"created_at":"2024-07-31T03:00:53.345Z","updated_at":"2025-05-14T02:04:46.684Z","avatar_url":"https://github.com/wb2osz.png","language":"C","funding_links":[],"categories":["C","🛠 Software \u0026 Tools","Software"],"sub_categories":["Other Boards","APRS","Other"],"readme":"\n# Dire Wolf #\n\n### Decoded Information from Radio Emissions for Windows Or Linux Fans ###\n\nIn the early days of Amateur Packet Radio, it was necessary to use an expensive \"Terminal Node Controller\" (TNC) with specialized hardware.  Those days are gone.  You can now get better results at lower cost by connecting your radio to the \"soundcard\" interface of a computer and using software to decode the signals.\n\nWhy waste $200 and settle for mediocre receive performance from a 1980's technology  TNC using an old modem chip?   Dire Wolf decodes over 1000 error-free frames from Track 2 of the [WA8LMF TNC Test CD](https://github.com/wb2osz/direwolf/tree/dev/doc/WA8LMF-TNC-Test-CD-Results.pdf), leaving all the hardware TNCs, and first generation \"soundcard\" modems, behind in the dust.\n\n![](tnc-test-cd-results.png)\n\nDire Wolf includes [FX.25](https://en.wikipedia.org/wiki/FX.25_Forward_Error_Correction) which adds Forward Error Correction (FEC) in a way that is completely compatible with existing systems.  If both ends are capable of FX.25, your information will continue to get through under conditions where regular AX.25 is completely useless. This was originally developed for satellites and is now seeing widespread use on HF.\n\n![](fx25.png)\n\nVersion 1.7 adds [IL2P](https://en.wikipedia.org/wiki/Improved_Layer_2_Protocol), a different method of FEC with less overhead but it is not compatible with AX.25.\n\n\n\n### Dire Wolf is a modern software replacement for the old 1980's style TNC built with special hardware. ###\n\nWithout any additional software, it can perform as:\n\n - APRS GPS Tracker\n - Digipeater\n - Internet Gateway (IGate)\n- [APRStt](http://www.aprs.org/aprstt.html) gateway\n\n\nIt can also be used as a virtual TNC for other applications such as [APRSIS32](http://aprsisce.wikidot.com/), [Xastir](http://xastir.org/index.php/Main_Page), [APRS-TW](http://aprstw.blandranch.net/), [YAAC](http://www.ka2ddo.org/ka2ddo/YAAC.html), [PinPoint APRS](http://www.pinpointaprs.com/), [UI-View32](http://www.ui-view.net/),[UISS](http://users.belgacom.net/hamradio/uiss.htm), [Linux AX25](http://www.linux-ax25.org/wiki/Main_Page), [SARTrack](http://www.sartrack.co.nz/index.html), [Winlink Express (formerly known as RMS Express, formerly known as Winlink 2000 or WL2K)](http://www.winlink.org/RMSExpress), [BPQ32](http://www.cantab.net/users/john.wiseman/Documents/BPQ32.html), [Outpost PM](http://www.outpostpm.org/), [Ham Radio of Things](https://github.com/wb2osz/hrot), [Packet Compressed Sensing Imaging (PCSI)](https://maqifrnswa.github.io/PCSI/), and many others.\n \n \n## Features \u0026 Benefits ##\n\n![](direwolf-block-diagram.png)\n\n### Dire Wolf includes: ###\n\n\n\n- **Beaconing, Tracker, Telemetry Toolkit.**\n\n     Send periodic beacons to provide information to others.  For tracking the location is provided by a GPS receiver.\n     Build your own telemetry applications with the toolkit.\n\n\n- **APRStt Gateway.**\n\n     Very few hams have portable equipment for APRS but nearly everyone has a handheld radio that can send DTMF tones.  APRStt allows a user, equipped with only DTMF (commonly known as Touch Tone) generation capability, to enter information into the global APRS data network.  Responses can be sent by Morse Code or synthesized speech.\n\n- **Digipeaters for APRS and traditional Packet Radio.**\n\n    Extend the range of other stations by re-transmitting their signals. Unmatched flexibility for cross band repeating and filtering to limit what is retransmitted.\n\n- **Internet Gateway (IGate).**\n\n    IGate stations allow communication between disjoint radio networks by allowing some content to flow between them over the Internet.\n\n- **Ham Radio of Things (HRoT).**\n\n    There have been occasional mentions of merging Ham Radio with the Internet of Things but only ad hoc incompatible narrowly focused applications. Here is a proposal for a standardized more flexible method so different systems can communicate with each other.\n\n    [Ham Radio of Things - IoT over Ham Radio](https://github.com/wb2osz/hrot)\n\n- **AX.25 v2.2 Link Layer.**\n\n    Traditional connected mode packet radio where the TNC automatically retries transmissions and delivers data in the right order.\n\n- **KISS Interface (TCP/IP, serial port, Bluetooth) \u0026 AGW network Interface (TCP/IP).**\n\n    Dire Wolf can be used as a virtual TNC for applications such as [APRSIS32](http://aprsisce.wikidot.com/), [Xastir](http://xastir.org/index.php/Main_Page), [APRS-TW](http://aprstw.blandranch.net/), [YAAC](http://www.ka2ddo.org/ka2ddo/YAAC.html), [PinPoint APRS](http://www.pinpointaprs.com/), [UI-View32](http://www.ui-view.net/),[UISS](http://users.belgacom.net/hamradio/uiss.htm), [Linux AX25](http://www.linux-ax25.org/wiki/Main_Page), [SARTrack](http://www.sartrack.co.nz/index.html), [Winlink Express (formerly known as RMS Express, formerly known as Winlink 2000 or WL2K)](http://www.winlink.org/RMSExpress), [BPQ32](http://www.cantab.net/users/john.wiseman/Documents/BPQ32.html), [Outpost PM](http://www.outpostpm.org/), [Ham Radio of Things](https://github.com/wb2osz/hrot), [Packet Compressed Sensing Imaging (PCSI)](https://maqifrnswa.github.io/PCSI/), and many others.\n\n### Radio Interfaces:   ###\n\n- **Uses computer's \"soundcard\" and digital signal processing.**\n\n    Lower cost and better performance than specialized hardware. \n\n    Compatible interfaces include [DRAWS](http://nwdigitalradio.com/draws/), [UDRC](https://nw-digital-radio.groups.io/g/udrc/wiki/UDRC%E2%84%A2-and-Direwolf-Packet-Modem), [SignaLink USB](http://www.tigertronics.com/slusbmain.htm), [DMK URI](http://www.dmkeng.com/URI_Order_Page.htm), [RB-USB RIM](http://www.repeater-builder.com/products/usb-rim-lite.html), [RA-35](http://www.masterscommunications.com/products/radio-adapter/ra35.html), [DINAH](https://hamprojects.info/dinah/), [SHARI](https://hamprojects.info/shari/), and many others.\n\n\n\n- **Modems:**\n\n    300 bps AFSK for HF\n\n    1200 bps AFSK most common for VHF/UHF\n\n    2400 \u0026 4800 bps PSK\n\n    9600 bps GMSK/G3RUH\n\n    AIS reception\n\n    EAS SAME reception\n\n\n\n- **DTMF (\"Touch Tone\") Decoding and Encoding.**\n \n- **Speech Synthesizer interface \u0026 Morse code generator.**\n\n    Transmit human understandable messages.\n\n- **Compatible with Software Defined Radios such as gqrx, rtl_fm, and SDR#.**\n\n- **Concurrent operation with up to 3 soundcards and 6 radios.**\n\n### Portable \u0026 Open Source:   ###\n\n- **Runs on Windows, Linux (PC/laptop, Raspberry Pi, etc.), Mac OSX.**\n\n\n\n## Documentation ##\n\n\n[Stable Version](https://github.com/wb2osz/direwolf/tree/master/doc)\n\n[Latest Development Version (\"dev\" branch)](https://github.com/wb2osz/direwolf/tree/dev/doc)\n\n[Additional Topics](https://github.com/wb2osz/direwolf-doc)\n\n[Power Point presentations](https://github.com/wb2osz/direwolf-presentation)  -- Why not give a talk at a local club meeting?\n\nYoutube has many interesting and helpful videos.  Searching for [direwolf tnc](https://www.youtube.com/results?search_query=direwolf+tnc) or [direwolf aprs](https://www.youtube.com/results?search_query=direwolf+aprs)  will produce the most relevant results. \n\n## Installation ##\n\n### Windows ###\n\nGo to the [**releases** page](https://github.com/wb2osz/direwolf/releases).   Download a zip file with \"win\" in its name, unzip it, and run direwolf.exe from a command window.\n\nYou can also build it yourself from source.  For more details see the **User Guide** in the [**doc** directory](https://github.com/wb2osz/direwolf/tree/master/doc).\n\n\n\n\n### Linux - Using git clone (recommended) ###\n\n***Note that this has changed for version 1.6.  There are now a couple extra steps.***\n\n\nFirst you will need to install some software development packages using different commands depending on your flavor of Linux.\nIn most cases, the first few  will already be there and the package installer will tell you that installation is not necessary.\n\nOn Debian / Ubuntu / Raspbian / Raspberry Pi OS:\n\n    sudo apt-get install git\n    sudo apt-get install gcc\n    sudo apt-get install g++\n    sudo apt-get install make\n    sudo apt-get install cmake\n    sudo apt-get install libasound2-dev\n    sudo apt-get install libudev-dev\n    sudo apt-get install libavahi-client-dev\n\nOr on Red Hat / Fedora / CentOS:\n\n    sudo yum install git\n    sudo yum install gcc\n    sudo yum install gcc-c++\n    sudo yum install make\n    sudo yum install alsa-lib-devel\n    sudo yum install libudev-devel\n    sudo yum install avahi-devel\n\nCentOS 6 \u0026 7 currently have cmake 2.8 but we need 3.1 or later.\nFirst you need to enable the EPEL repository.  Add a symlink if you don't already have the older version and want to type cmake rather than cmake3.\n\n    sudo yum install epel-release\n\tsudo rpm -e cmake\n\tsudo yum install cmake3\n\tsudo ln -s /usr/bin/cmake3 /usr/bin/cmake\n\nThen on any flavor of Linux:\n\n\tcd ~\n\tgit clone https://www.github.com/wb2osz/direwolf\n\tcd direwolf\n    git checkout dev\n\tmkdir build \u0026\u0026 cd build\n\tcmake ..\n\tmake -j4\n\tsudo make install\n\tmake install-conf\n\nThis gives you the latest development version.  Leave out the \"git checkout dev\" to get the most recent stable release.\n\nFor more details see the **User Guide** in the [**doc** directory](https://github.com/wb2osz/direwolf/tree/master/doc).  Special considerations for the Raspberry Pi are found in **Raspberry-Pi-APRS.pdf**\n\n\n### Linux - Using apt-get (Debian flavor operating systems) ###\n\nResults will vary depending on your hardware platform and operating system version because it depends on various volunteers who perform the packaging. Expect the version to lag significantly behind development.\n\n\tsudo apt-get update\n\tapt-cache showpkg direwolf\n\tsudo apt-get install direwolf\n\n\n### Linux - Using yum (Red Hat flavor operating systems) ###\n\nResults will vary depending on your hardware platform and operating system version because it depends on various volunteers who perform the packaging.  Expect the version to lag significantly behind development.\n\n\tsudo yum check-update\n\tsudo yum list direwolf\n\tsudo yum install direwolf\n\n\n### Macintosh OS X ###\n\nRead the **User Guide** in the [**doc** directory](https://github.com/wb2osz/direwolf/tree/master/doc).   It is more complicated than Linux.\n\nIf you have problems,  post them to the [Dire Wolf packet TNC](https://groups.io/g/direwolf) discussion group.\n\nYou can also install a pre-built version from Mac Ports.  Keeping this up to date depends on volunteers who perform the packaging. This version could lag behind development.\n\n\tsudo port install direwolf\n\n\n## Join the conversation  ##\n \nHere are some good places to ask questions and share your experience:\n\n- [Dire Wolf Software TNC](https://groups.io/g/direwolf) \n\n- [Raspberry Pi 4 Ham Radio](https://groups.io/g/RaspberryPi-4-HamRadio)\n\n- [linuxham](https://groups.io/g/linuxham)\n\n- [TAPR aprssig](http://www.tapr.org/pipermail/aprssig/)\n \n\nThe github \"issues\" section is for reporting software defects and enhancement requests.  It is NOT a place to ask questions or have general discussions.  Please use one of the locations above.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwb2osz%2Fdirewolf","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fwb2osz%2Fdirewolf","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwb2osz%2Fdirewolf/lists"}