Repository navigation
Releases
v.1.2.0
Troopers Transfer v1.2.0
A fresh new look, nine themes, and built-in updates that also keep croc up to date.
Project status: feature-complete
Troopers Transfer is now feature-complete. Sending, receiving, hosting your own relay, connecting to a friend's relay, themes and updates are all in place. From here on I'll only be working on bug reports and compatibility reports (for example, routers where hosting doesn't work). No new features are planned. See How to report a bug below.
Download
- Windows (64-bit):
TroopersTransfer-windows-amd64.zip. Unzip it and runTroopersTransfer.exe. It's portable, so there's nothing to install. - Upgrading: put the new exe in place of your old one. Your settings in
TroopersTransfer.jsoncarry over automatically. From this version on, you can upgrade from inside the app (see below).
What's new
A refreshed look
- Sidebar navigation. Send, Receive, Host, Connect, History and Settings are now down the left side.
- Relay status in the header. The header shows which relay you're on at a glance: Using the public relays, Using relay 1.2.3.4:9009, or Hosting a relay on port 9009.
- Cleaner pages. Every tab is a page with a title, a short explanation and tidy cards.
- More room while sending. The controls tuck away during a transfer, so the code phrase and QR code are easy to see.
- Nothing removed. Every button, setting and feature from 1.1 is still here and works the same way.
Themes
Nine themes to choose from:
| Theme | Look |
|---|---|
| Midnight (new default) | Deep navy with a blue accent |
| Daylight | Light grey and white with a blue accent |
| Trooper | Dark olive with a khaki accent |
| Forest | Dark green with a green accent |
| Ember | Dark brown with an orange accent |
| Nightshade | Dark purple with a lilac accent |
| Ocean | Dark teal with an aqua accent |
| High contrast | Black and white with a yellow accent, for readability |
| System | Follows your Windows light or dark mode |
How to use it: open Settings → Appearance and pick a theme from the list, or click one of the theme buttons (each shows its colours). It changes instantly and is remembered next time you open the app.
Built-in updates
How to use it: open Settings → Updates and click Check for updates.
- The card shows the version you have and the version of croc built into it.
- If a newer Troopers Transfer is available, click Update to … and restart. The app downloads it, checks it, swaps itself out and restarts into the new version.
- If you're in the middle of a transfer or hosting, it asks before restarting.
- If anything goes wrong (no internet, a damaged download, or the app is in a folder like Program Files that it can't write to), nothing is changed and it tells you what to do.
- The app only contacts GitHub when you click the button. There's no automatic checking in the background.
croc upgrades
croc is built into Troopers Transfer, so new croc versions now come to you as normal app updates. Settings → Updates shows which croc you have and the latest croc release. When a newer croc is out, I test it with the app and ship it in an update, and Check for updates will offer it.
Verified downloads
Releases now include a .sha256 checksum file. The updater checks each download against it and won't install one that doesn't match.
How to report a bug
Since the project is feature-complete, bug reports and compatibility reports are what keep it working for everyone. Please open an Issue and include as much of the following as you can.
Every bug report
- Your Troopers Transfer version: shown in the header, and in Settings → Updates.
- Your Windows version: for example Windows 11 23H2.
- What you were doing: sending, receiving, hosting or connecting.
- What you expected to happen, and what happened instead.
- Steps to reproduce it, if you can.
- A screenshot of any error message. Expand Technical details first if there's an expander, since that text helps the most.
Hosting and router problems
These depend on your router, so I need to know which router you have:
| Information | Where to find it | Required? |
|---|---|---|
| Router type / brand | e.g. ARRIS, Netgear, TP-Link, ASUS, or your ISP's gateway (Xfinity, Spectrum, etc.) | Yes |
| Model number | On the sticker on the router (e.g. TG1682G, SBG8300), or on its settings page | Yes |
| Firmware version | On the router's settings page, usually under Status, Gateway, System or About | If you can |
If you can't find all three, I need at least the router type and model number. The firmware version helps a lot, because the same model can behave differently between updates. A report without the type and model is very hard for me to act on.
For hosting problems, please also include:
- The heading shown in the Host tab (for example Couldn't open the ports automatically), and a screenshot of Technical details.
- Whether UPnP is turned on in your router.
- Whether you forwarded the ports yourself, and if so, what Check my ports online said.
- Whether you use a VPN.
Notes
- Windows may show a SmartScreen warning because the exe isn't code-signed. Click More info → Run anyway.
- The first time you host, click Allow when Windows asks about the firewall.
- Your internet connection code contains your public IP address, so only share it with people you trust.
- Both people need Troopers Transfer, or the
croccommand-line tool. When using a hosted relay, both people need to be on the same relay.
V1.1.3
Troopers Transfer v1.1.3
Makes hosting work on more routers, and makes it much easier when your router won't open the ports itself.
Project status
With this release, Troopers Transfer is essentially feature-complete. Sending, receiving, hosting your own relay and connecting to a friend's all work, and from here I'm focusing on fixes and polish rather than new features.
If you find a bug or something doesn't work on your router, please open an Issue with the type of router, it's model number, and what firmware it's using. if you can't give me all 3 i need at least it's type and model number.
Download
- Windows (64-bit):
TroopersTransfer-windows-amd64.zip. Unzip it and runTroopersTransfer.exe. It's portable, so there's nothing to install. Your settings carry over if you copyTroopersTransfer.jsonfrom your old folder.
Finds more routers
- Asks your router directly. As well as the usual UPnP search, the app now sends its request straight to your router's address. On Windows PCs with WSL, Hyper-V or a VPN installed, the usual search often went out through a virtual network adapter and never reached the router, so the app wrongly said UPnP was off.
- Searches through the right network adapter. The broadcast-style (multicast) search now goes out through the adapter that's actually connected to your router.
- Broader searches. Some ISP gateways only answer generic UPnP searches, and the app now tries those too.
- Faster. When the router answers, the ports open in a moment instead of after a long wait.
Easier manual port forwarding
- New "I've opened the ports" button. If your router doesn't support UPnP, follow the steps to forward the ports yourself, then click this. The app stops asking the router and just shows your connection codes. Before, the steps sent you to Try again, which could never succeed on a router without working UPnP.
- New "Check my ports online" button. After forwarding the ports by hand, this opens a port checker so you can confirm friends can reach you before you send them the code.
- Better tips. The app now mentions that some routers only start UPnP after a restart.
Fixes
- Clearer technical details. When the router can't be found, they now say how many replies came back directly and by multicast, and which devices answered. That makes problems much easier to diagnose.
- Ports are freed as soon as you stop hosting. Before, they could stay busy for a moment, so starting again straight away sometimes failed.
- Fixed a test that sometimes failed on the Windows build.
Docs
- README updated with a guide to the new buttons, an ARRIS gateway example, and troubleshooting entries for "UPnP is enabled but the app says it didn't answer" and "I forwarded the ports but the warning is still there".
Notes
- If your router doesn't answer UPnP, which is common on ISP gateways, forward TCP ports 9009–9013 (or your starting port and the four after it) to your PC. Then click I've opened the ports. The Host tab shows the exact steps for your network.
- Windows may show a SmartScreen warning because the exe isn't code-signed. Click More info → Run anyway.
- The first time you host, click Allow when Windows asks about the firewall.
- Your internet connection code contains your public IP address, so only share it with people you trust.
V1.1.0
Troopers Transfer v1.1.0
Host your own relay with one click. No command line, no setting up a server.
Until now, every transfer went through croc's public relays. In 1.1 you can turn your own PC into the relay you and your friends transfer through. That's often faster than a busy public relay, and your files never touch anyone else's server.
Download
- Windows (64-bit):
TroopersTransfer-windows-amd64.zip. Unzip it and runTroopersTransfer.exe. It's still portable, so there's nothing to install.
Upgrading from 1.0: your settings are kept in TroopersTransfer.json next to the exe. If you unzip 1.1 into a new folder, copy that file across to keep them.
New: Host tab (Auto Host Relay)
- Start hosting runs a relay on your PC. One click, no command line.
- Router ports opened automatically. The app asks your router to open the ports using UPnP, or NAT-PMP if UPnP isn't available. They're closed again when you stop hosting or quit, and if the app crashes, the router forgets them within an hour.
- Connection codes to share. You get one code for friends over the internet and one for friends on your Wi-Fi, each with a Copy button. A code looks like
203.0.113.5:9009/amber-falcon-ridge. - Your own transfers use your relay automatically while you're hosting.
New: Plain-English router help
If your router won't open the ports, the app works out why and tells you exactly what to do:
- UPnP is turned off or not supported
- The router refused the request
- Another device is already using the ports
- Your internet provider shares one public address between customers (carrier-grade NAT). The app tells you plainly that port forwarding can't fix this, so you don't waste time in your router settings.
- Your router is plugged into a second router or modem
- A VPN is hiding your real address
- Another program on your PC is using the ports
When forwarding the ports by hand will fix it, you get numbered steps that already include your router's address, your PC's IP address and the exact ports. There are also Copy these steps, Try again and Router guides buttons.
New: Connect tab (Auto Join Relay)
- Paste a friend's connection code and click Connect.
- Before switching, the app checks that the relay answers, that the password is right, and that all five ports can be reached.
- If something's wrong, it says what: wrong password, host not running, blocked by a firewall, or only some ports forwarded.
- Test connection checks a code without switching. It's handy for the host to confirm their setup works.
- Use public relays switches back.
Improvements
- README rewritten with step-by-step hosting instructions, a manual port forwarding guide, troubleshooting and new screenshots.
- Fixed the Linux build on GitHub Actions.
Coming soon
- Linux build. Linux support is planned for a future release.
- Update Croc button. Update croc with the push of a button.
Notes
- Windows may show a SmartScreen warning because the exe isn't code-signed. Click More info → Run anyway.
- The first time you host, Windows will ask whether to allow Troopers Transfer through the firewall. Click Allow, or friends won't be able to connect.
- Automatic port opening depends on your router. If it doesn't work on yours, please open an Issue and say which router you have.
- Your internet connection code contains your public IP address, so only share it with people you trust.
- Both people need Troopers Transfer, or the
croccommand-line tool, to send and receive. When using a hosted relay, both people need to be on the same relay.
v1.0.0
Troopers Transfer v1.0.0
The first public release of Troopers Transfer. Send files and folders between any two computers with a 6 digit minimum code. No accounts, no installer, no cloud storage.
The app is close to feature-complete. The core send and receive flow works, and I'm mostly polishing from here. Bug reports and suggestions are welcome in Issues.
Download
- Windows (64-bit):
TroopersTransfer-windows-amd64.zip. Unzip it and runTroopersTransfer.exe. It's portable, so there's nothing to install.
Features
- Send files or whole folders with a simple three-word code
- Accept or decline incoming transfers before anything is saved
- Transfer history
- Configurable settings, including the download location
- Built on croc, so transfers are encrypted end to end
Coming soon
- Linux build. Linux support is planned and will be added in a future release.
- Update Croc Button. Update Croc with the push of a button
- Auto Host Relay, Auto Join Relay Create and join Relay's automatically, so you truly don't have to mess with a Command Line.
Notes
- Windows may show a SmartScreen warning because the exe isn't code-signed. Click More info → Run anyway.
- Both people need Troopers Transfer, or the
croccommand-line tool, to send and receive.