Show HN: NetSour, CLI Based Wireshark
github.com
github.com
The comments are there to help you improve, not to put you down.
---------------------------------------
You're not alone. Even worse when it is a product page. Just how often I see some product or project and are unable to actually determine what the thing does or why I would want to use it or even HOW to use it.
I can give GitHub projects a pass when someone else links them, but the poster is the author so no pass. This is "Show HN". Please __show__. I do like to try out new projects and tools, but where's the hook?
Also, do not underestimate the importance of documentation. Hell, I document predominantly for myself. I know I'm not alone in forgetting how things work if I haven't touched a project in awhile (which can even be going to lunch on bad days). This is also critical for any users. Encourage them to add docs, make it easy, and when addressing issues recognize that just because it is in the docs does not mean it's interpretable from user context.
If you want to demonstrate a CLI or TUI tool, a common helper is asciinema[0]. You can record your terminal and they'll host the output for you. You'll frequently see these on GitHub and even a 10 second video that is clunky/slow with key presses (or way too fast) is better than nothing. UIs matter and aren't as simple/obvious as many think.
Also, drop a license file in there. Not just a line in your README. Come on, GitHub even hands these files to you so it is the same work to write in your README as it is to drop that file in (though you should always mod those licenses headers to be about you and your project). Without the license file, your license is ambiguous and may not actually protect your project as intended. The full text needs to exist.
And just remember: never fear pushing back (even against seniors) and never confuse criticism about your work with an attack on you as a person. I mean all our code is shit. If a year from now you don't look back at your code and think "this is shit" then it probably means you are no longer improving (conversely if you are feeling discouraged and like you're getting nowhere, go back and look at your old code because it makes the improvements rather obvious lol).
Good luck. Keep it up and you'll do great. So don't stress and don't forget to have fun (very common mistake, especially by adults)
It looks basically exactly like the Wireshark UI, but it's a TUI. So if I need some more interactivity than tcpdump, I use termshark instead.
* There's a "screensaver" which activates after a couple seconds and requires extra button presses to get back to real data
* In several sessions the TUI output got corrupt
* It has problems with remembering field expansion - I'd expand one field and it'd expand all the other fields after a second delay, while looking at the same message even.
* It felt pretty slow to start up
* I felt like I had some issues with filter accuracy
But it got the job done and most issues were easy enough to work around.
What’s the advantage of this over using tcpdump directly?
But that aside, the addons idea is an interesting one.
EDIT: I wonder if there is some nice TUI debugger interface/IDE that one could reuse for this. Handling traces Live like this has always been a special skill so I guess specialized tools is a must.. But one would think that all the tooling around KUtrace/ebpf/tcpdump could be generalized in some way.
Edit: I really like this simple Scapy wrapper though! Works like a charm.
DoS attacks attempt to overwhelm your system or your system's connection by sheer amount of packets. And here you are capturing those packets and keeping them in memory - this just makes your system fall over faster.
Any thoughts on how to differentiate your work from other cli packet capturing and display utilities such as gosniff or termshark?
[0] https://asciinema.org/ | https://news.ycombinator.com/item?id=41010530
For example, if you have your screenshots in a directory in the repo called `docs/images` you can include it with:
