Skip to content

Add demo videos and Wireshark debugging section to README#242

Merged
compscidr merged 3 commits intomainfrom
docs/readme-videos-debugging
Apr 29, 2026
Merged

Add demo videos and Wireshark debugging section to README#242
compscidr merged 3 commits intomainfrom
docs/readme-videos-debugging

Conversation

@compscidr
Copy link
Copy Markdown
Owner

Summary

  • Adds links to two YouTube demos under a new "Demo videos" section: a plain Android sample-app run and one with Wireshark attached
  • Adds a "Debugging with Wireshark" section that documents how to connect to the embedded `PcapNgTcpServerPacketDumper`
  • Calls out the Linux ports (19000 for client, 19001 for server via `DEFAULT_PORT + 1`) and explicitly notes that for Android you need the phone's Wi-Fi IP (not `127.0.0.1`) and same-subnet/firewall caveats

Test plan

  • Render README on GitHub and confirm the YouTube links and code blocks display correctly
  • Verify the Wireshark commands work end-to-end (Linux client/server and Android phone)

🤖 Generated with Claude Code

Adds two YouTube links showing the Android sample app in action (one
plain, one with Wireshark attached to the in-app pcap-ng server), and
a debugging subsection that documents how to attach Wireshark to the
embedded PcapNgTcpServerPacketDumper for the Linux server/client and
the Android app. The Android case explicitly calls out using the
phone's Wi-Fi IP (not 127.0.0.1) and the same-subnet/firewall caveats.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Copilot AI review requested due to automatic review settings April 29, 2026 18:16
Copy link
Copy Markdown

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Updates the project README to improve onboarding by adding video demos and practical instructions for capturing the in-app packet dump stream with Wireshark.

Changes:

  • Add a new “Demo videos” section with two YouTube links showcasing the Android sample app.
  • Add a “Debugging with Wireshark” section documenting how to attach Wireshark to the embedded PcapNgTcpServerPacketDumper.
  • Document host/port details and Android-specific connectivity constraints (phone Wi‑Fi IP, same subnet, firewall/AP isolation).

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread README.md Outdated
Comment thread README.md Outdated
Comment thread README.md Outdated
GitHub strips iframes from rendered markdown so YouTube videos can't
play inline; switching to the conventional thumbnail-as-clickable-link
pattern (maxresdefault.jpg) gives a visual preview in a side-by-side
table that opens the video on YouTube when clicked.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@codecov
Copy link
Copy Markdown

codecov Bot commented Apr 29, 2026

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 60.67%. Comparing base (c03a945) to head (85da4a9).
⚠️ Report is 4 commits behind head on main.

Additional details and impacted files
@@             Coverage Diff              @@
##               main     #242      +/-   ##
============================================
- Coverage     61.69%   60.67%   -1.02%     
+ Complexity      231      229       -2     
============================================
  Files            15       15              
  Lines          2070     2070              
  Branches        315      315              
============================================
- Hits           1277     1256      -21     
- Misses          611      642      +31     
+ Partials        182      172      -10     
Flag Coverage Δ
libunittests 60.67% <ø> (-1.02%) ⬇️

Flags with carried forward coverage won't be shown. Click here to find out more.

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

- Drop the misleading 'port 19000' summary; the client uses 19000 but
  the server uses 19001, so the intro now leaves the port to the
  per-target sub-bullets.
- Reference PcapNgTcpServerPacketDumper.DEFAULT_PORT explicitly
  instead of an unqualified DEFAULT_PORT, since KAnonProxy.DEFAULT_PORT
  also exists in this repo (8080) and could be confused.
- Note that the Android pcap server is not started with the VPN -
  startPcapServer() must be triggered from the app UI before Wireshark
  can connect.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@compscidr compscidr merged commit 2ceb1be into main Apr 29, 2026
3 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants