Skip to content

docs: document importing eMule statistics into aMule - #195

Merged
got3nks merged 1 commit into
amule-org:mainfrom
got3nks:docs/import-emule-statistics
Jul 31, 2026
Merged

docs: document importing eMule statistics into aMule#195
got3nks merged 1 commit into
amule-org:mainfrom
got3nks:docs/import-emule-statistics

Conversation

@got3nks

@got3nks got3nks commented Jul 31, 2026

Copy link
Copy Markdown
Contributor

The migration guide stated eMule statistics could not be imported. They can — eMule and aMule store the same two cumulative counters (total uploaded / downloaded bytes), just in different container formats:

  • eMule: statistics.ini, [Statistics], decimal TotalUploadedBytes / TotalDownloadedBytes
  • aMule: statistics.dat, a 0x00 version byte followed by two little-endian uint64s (uploaded, then downloaded)

The values map 1:1, so a short script converts one to the other.

Changes:

  • Replace "Statistics Cannot Be Imported" with "Importing Statistics", including a zero-dependency bash converter (Linux/macOS) and a PowerShell converter (Windows).
  • Remove statistics.ini from the "not used / can be ignored" list — it is the import source.
  • Update the summary table row.

Both converters were verified byte-for-byte against a real eMule statistics.ini.

Prompted by amule-org/amule#713.

The migration guide claimed eMule statistics could not be imported.
Both clients store the same two cumulative counters (total uploaded and
downloaded bytes), only in different container formats: eMule in
statistics.ini [Statistics] as decimals, aMule in statistics.dat as a
version byte plus two little-endian uint64s. Replace the "Statistics
Cannot Be Imported" section with a conversion procedure (bash and
PowerShell), drop statistics.ini from the "can be ignored" list, and
update the summary table.
@got3nks
got3nks merged commit 83b39f5 into amule-org:main Jul 31, 2026
2 checks passed
@got3nks
got3nks deleted the docs/import-emule-statistics branch July 31, 2026 08:18
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.

1 participant