a2qlinux 0.2.0__py3-none-any.whl

a2qlinux-0.2.0.dist-info/METADATA

@@ -0,0 +1,142 @@
+Metadata-Version: 2.5
+Name: a2qlinux
+Version: 0.2.0
+Summary: Questlog Desktop (AION 2 damage meter) on Linux under Proton, with live game traffic.
+Project-URL: homepage, https://github.com/raman78/A2Qlinux
+Project-URL: repository, https://github.com/raman78/A2Qlinux
+Project-URL: issues, https://github.com/raman78/A2Qlinux/issues
+Author: raman78
+License: MIT License
+        
+        Copyright (c) 2026 raman78
+        
+        Permission is hereby granted, free of charge, to any person obtaining a copy
+        of this software and associated documentation files (the "Software"), to deal
+        in the Software without restriction, including without limitation the rights
+        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+        copies of the Software, and to permit persons to whom the Software is
+        furnished to do so, subject to the following conditions:
+        
+        The above copyright notice and this permission notice shall be included in all
+        copies or substantial portions of the Software.
+        
+        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+        SOFTWARE.
+License-File: LICENSE
+Keywords: aion2,dps-meter,linux,proton,questlog,wine
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: X11 Applications :: Qt
+Classifier: Natural Language :: English
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Games/Entertainment
+Requires-Python: >=3.11
+Requires-Dist: pyqt6>=6.5
+Requires-Dist: python-xlib>=0.33
+Description-Content-Type: text/markdown
+
+# A2Qlinux
+
+Run [Questlog Desktop](https://questlog.gg/aion-2/en/app), the Windows-only
+damage meter and overlay app for AION 2, on Linux next to the game under
+Steam's Proton, with live game traffic.
+
+Questlog reads the game's traffic through Npcap, a Windows driver that cannot
+work under Wine/Proton. A2Qlinux captures the traffic on the Linux side with
+`dumpcap` and hands it to Questlog through its own stand-in for Npcap's
+`wpcap.dll`. Questlog runs inside the game's Proton prefix, in its normal
+live-capture mode, with its overlays over the game. Its program files stay
+as shipped; the only change A2Qlinux makes to Questlog's folder is removing
+the configuration of Questlog's own updater, which cannot install under
+Proton (A2Qlinux updates it instead).
+
+It also handles what comes with sharing a Wine session with a fullscreen
+game:
+
+- starting Questlog before, after or together with the game (Steam launch
+  option), without blocking the game's launch;
+- keeping clicks in the game while Questlog's window is open behind it;
+- its own tray icon (Open / Quit) in place of Questlog's, whose menu opens
+  only once under Proton;
+- quitting Questlog without losing its last data and without touching the
+  game or other programs in the prefix;
+- updating Questlog: its own updater cannot install under Proton, so A2Qlinux
+  downloads new versions in the background (not while the game runs), checks
+  them against what it relies on, installs them at the next start and rolls
+  back if they do not start.
+
+Status: in daily use on CachyOS, KDE Plasma 6 (Wayland), Proton 11
+(`proton-cachyos-slr`), Questlog 0.1.37. Other distributions and desktops
+are untested; what they need (Steam from the distribution or Valve, not
+Flatpak; a system tray; Python 3.11 or newer; the packages per distribution)
+is in [docs/INSTALL.md](https://github.com/raman78/A2Qlinux/blob/main/docs/INSTALL.md#what-you-need-before-you-start).
+
+## Quick start
+
+The [installation guide](https://github.com/raman78/A2Qlinux/blob/main/docs/INSTALL.md) walks through each step, with the commands
+for Arch, Debian, Ubuntu, Fedora and openSUSE. In short:
+
+1. Install the packages A2Qlinux uses — see
+   [Installing the packages](https://github.com/raman78/A2Qlinux/blob/main/docs/INSTALL.md#installing-the-packages).
+2. Join the `wireshark` group and log in again — see
+   [Allowing capture](https://github.com/raman78/A2Qlinux/blob/main/docs/INSTALL.md#allowing-capture).
+3. `pipx install a2qlinux`, `pipx ensurepath`, open a new terminal, then
+   `a2qlinux-setup --desktop-shortcut`. It installs Questlog, checks
+   everything else and prints the command for anything still missing — see
+   [Installing A2Qlinux and Questlog](https://github.com/raman78/A2Qlinux/blob/main/docs/INSTALL.md#installing-a2qlinux-and-questlog).
+4. Start **Questlog (AION 2)** from the menu, or set the Steam launch option
+   that `a2qlinux-setup` prints.
+
+## Documentation
+
+- [docs/INSTALL.md](https://github.com/raman78/A2Qlinux/blob/main/docs/INSTALL.md) — requirements, installing, removal.
+- [docs/USING.md](https://github.com/raman78/A2Qlinux/blob/main/docs/USING.md) — starting, tray icon, playing.
+- [docs/UPDATING.md](https://github.com/raman78/A2Qlinux/blob/main/docs/UPDATING.md) — Questlog updates, installing Questlog
+  by hand, and updating A2Qlinux itself (`pipx upgrade a2qlinux`).
+- [docs/TROUBLESHOOTING.md](https://github.com/raman78/A2Qlinux/blob/main/docs/TROUBLESHOOTING.md) — problems, FAQ.
+- [docs/ARCHITECTURE.md](https://github.com/raman78/A2Qlinux/blob/main/docs/ARCHITECTURE.md) — how it works and why, failure
+  modes, tests, what a Questlog update can break.
+
+## Repository layout
+
+| Path | What |
+|---|---|
+| `a2qlinux/launcher.py` | launcher (`a2qlinux-run`): capture, bridge, starting/quitting Questlog, tray |
+| `a2qlinux/pcap_bridge.py` | TCP server that feeds captured packets to the DLL |
+| `a2qlinux/desktop.py` | `a2qlinux`: menu-entry entry point; one launcher at a time |
+| `a2qlinux/tray.py` | tray icon (PyQt6) |
+| `a2qlinux/config.py` | settings from `~/.config/a2qlinux/config.toml` |
+| `a2qlinux/update.py` | installing Questlog, and background Questlog updates: download, verify, check, install, roll back |
+| `a2qlinux/steam.py` | `a2qlinux-steam`: Steam launch-option wrapper |
+| `a2qlinux/setup_desktop.py` | `a2qlinux-setup`: dependency and capture checks with install commands, Questlog installation, menu entry, icon |
+| `a2qlinux/bin/` | the built Windows parts (shipped in the package, not in git) |
+| `bridge/` | Windows parts in C: `wpcap.dll` stand-in, `questlog_ctl.exe`, their tests; `build.sh` |
+| `tests/` | Python tests: `python3 -m unittest` |
+| `tools/` | diagnostics: replay-file tools, TCP-owner probe |
+
+The Windows parts are built with `clang` against the installed Wine's headers
+(`bridge/build.sh`) — by the release workflow for the packages, by hand in a
+source checkout; built files are not kept in the repository. Releasing:
+[docs/RELEASE.md](https://github.com/raman78/A2Qlinux/blob/main/docs/RELEASE.md).
+
+## Not affiliated
+
+A2Qlinux is an independent project, not made or endorsed by Questlog's
+authors or by AION 2's publisher. It contains no Questlog code or assets:
+Questlog is downloaded from its authors, and its icon is taken from your own
+installation. Questlog and its name belong to its authors (questlog.gg).
+
+Whether third-party meters are allowed is for the game's publisher, NCSOFT,
+to decide. It has not said so either way, and its rules forbid
+"unauthorized programs" in general terms. Using any third-party meter,
+under Windows or through A2Qlinux, is at your own risk; check the
+publisher's current rules.
+
+## License
+
+MIT — see [LICENSE](https://github.com/raman78/A2Qlinux/blob/main/LICENSE).

a2qlinux-0.2.0.dist-info/RECORD

@@ -0,0 +1,17 @@
+a2qlinux/__init__.py,sha256=zgsm4W0ETVfH-bu7idtLM7uk9Lz-1yhNTyW3i1FmpNI,249
+a2qlinux/_version.py,sha256=s9U3X54Pdr-Jlh9GP6LBaa_VRos7qs_wtrVefUHHNIA,520
+a2qlinux/config.py,sha256=SZbMJXbMPGZ1GkNUtVkBBPGl_7IaqIbSmv83lJ4JM9Q,6031
+a2qlinux/desktop.py,sha256=J2r58w21qj8YIJXFqi6KxC_qp_cStKf5s-ECoMGC1Rg,5062
+a2qlinux/launcher.py,sha256=hBuIKyxu0PJ0LvAbEdyP7QfVkAfJo_fp2uHqwmXAJ4M,51328
+a2qlinux/pcap_bridge.py,sha256=F6T9ao5rzEaldmqZgh5DPOqkQLbdtLFPOOZUfNKS-mk,7438
+a2qlinux/setup_desktop.py,sha256=H6W-xf220aBRAEsisflulH4Ye_z1GKcND9fW0F7EJqM,18404
+a2qlinux/steam.py,sha256=7sJCIlUd8BsLYV8C73btLUEfoRaBQjXaY4s67A-eM8g,4304
+a2qlinux/tray.py,sha256=yrxgpya5RChB7CL1wYUqSU6DQvE-JDmp2EWJs1RI1qY,2421
+a2qlinux/update.py,sha256=491sLD5J1YnDfhSaqNJh01ZwflMyuoNKHHy1fqx7uQM,19092
+a2qlinux/bin/questlog_ctl.exe,sha256=8YyTNkcSaIp3KVaD-YsytHeyQWsKvPExF4ivhgt78rE,9216
+a2qlinux/bin/wpcap.dll,sha256=-1BkLz50OrWXn68wb12IEeXtfqO7hKbNB_Qw1LggsgA,13824
+a2qlinux-0.2.0.dist-info/METADATA,sha256=OWzndMguqsQ0M4-1lFsteohyKV50k-utdP1Dg_9FFto,7810
+a2qlinux-0.2.0.dist-info/WHEEL,sha256=2iZrJkDIkeDh0k9SikKMqFuRP-ua6mb4Ir1AsER4BEw,87
+a2qlinux-0.2.0.dist-info/entry_points.txt,sha256=9JYUq5gxs5ScodExrdZoSv1BttMvhusNf6c6AM89Trk,170
+a2qlinux-0.2.0.dist-info/licenses/LICENSE,sha256=5a4nv_KEHxEaI5Q27Hlmi8Z244L-wOg2svp6utIXx_E,1064
+a2qlinux-0.2.0.dist-info/RECORD,,

a2qlinux-0.2.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.33.0
+Root-Is-Purelib: true
+Tag: py3-none-any

a2qlinux-0.2.0.dist-info/entry_points.txt

@@ -0,0 +1,5 @@
+[console_scripts]
+a2qlinux = a2qlinux.desktop:main
+a2qlinux-run = a2qlinux.launcher:run
+a2qlinux-setup = a2qlinux.setup_desktop:main
+a2qlinux-steam = a2qlinux.steam:main

a2qlinux-0.2.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 raman78
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.