What Hisaab sends, and how to switch it off
See exactly what leaves your computer, to whom, and how to turn anonymous usage statistics and crash reports on or off.
Your books stay on your computer. Hisaab sends nothing about how you use it unless you say yes, and what it can send then is fixed and small. This page lists every field.
It is off until you say yes#
The first time Hisaab starts after this version is installed, it asks once: Help improve Hisaab?
| Answer | Key | Effect |
|---|---|---|
| Yes, share | Y | Usage statistics and crash reports are both switched on |
| No thanks | N or Esc | Both stay off |
Enter does not answer the question, so it cannot be accepted by accident. If you quit Hisaab while the question is showing, the answer is no. The question is not asked again.
Change your answer#
- Open Settings (foot of the sidebar).
- Under Privacy, use the two switches: - Share anonymous usage - Send crash reports
A change takes effect at once. Hisaab reads your answer again immediately before every single message, so switching off stops even a message that was already waiting to go. The line under the switches says whether anything is being sent in this session.
Note: Switching on Send crash reports also sends the reports that are already waiting on this computer, including ones written before you said yes. To keep them from being sent, click Delete crash reports first. The line under the switches says how many are waiting.
See exactly what is sent#
Under Privacy, click See exactly what is sent. The box shows the address the messages go to, an example of each message built by the same code that sends the real one, and the last message sent in this session, word for word. If a crash report is waiting, the box shows that report as it would be sent. It also repeats the note above: reports already waiting are sent when you switch crash reports on, and Delete crash reports removes them first.
Usage statistics#
Sent only when Share anonymous usage is on and the website says it is collecting.
| When | What is sent |
|---|---|
| Once each time Hisaab starts | The event name app_start, the version (0.6.3), the operating system (windows, macos or linux) and the processor type (x86_64 or aarch64) |
| When you open a screen | The fixed name of the screen, for example /screen/voucher-form or /screen/report/trial-balance |
Every message also carries two fixed labels: the website's own statistics number, and the text app.hisaab.
A screen name says which kind of screen was opened, never what was on it. Opening the ledger of a party sends /screen/report/ledger. Opening a voucher sends /screen/voucher. The names are written into the program; there is no place in the message where anything else could go.
At most about one message a second is sent. If the internet is down, the messages are dropped, not kept for later.
Crash reports#
If Hisaab stops unexpectedly, it writes a small report file on your computer. That happens whether or not you share anything, so that you can tell us about it yourself.
Sent only when Send crash reports is on and the website says it is collecting. Waiting reports go when Hisaab starts, and at the moment you switch Send crash reports on:
| Field | Example |
|---|---|
| A random number for this one report | 5f0c… (new for every report) |
| Version | hisaab@0.6.3 |
| Operating system and processor type | windows, x86_64 |
| When it happened | Date and time |
| The place in the program | hisaab-ui/src/actions.rs:77:13 (file, line, column) |
| The name of the program thread | main |
The error text is not sent. It can quote what you were working on, so it stays in the file on your computer.
The place in the program never includes a folder of yours. A path such as /Users/asha/src/… or C:\Users\asha\… is cut down to the program's own part, or to the file name alone, before the report is written.
Once a report has been sent, its file is deleted and the count under the switches goes down. If it could not be sent, it waits for the next start. If you switch crash reports off while several are being sent, the rest stay on this computer. At most 5 reports are kept, none longer than 30 days.
Reports kept on this computer#
The files are in the crashes folder inside the data folder. Under Privacy, the line below the switches says how many there are, and Delete crash reports removes them. Reports that are waiting when you switch Send crash reports on are sent, so delete them first if you do not want that.
After Hisaab has stopped unexpectedly, the next start shows one line in the status bar, and the About screen offers Report a problem. That opens the support form in your browser with the version and system filled in. You write the rest.
What is never sent#
- Company names, ledger names, party names, item names.
- Amounts, quantities, voucher numbers, dates of vouchers.
- Anything you type, including search text and narrations.
- File names and folder paths.
- Your name, your user name in Hisaab, your computer's name.
- Any number that identifies you, your computer or this installation.
Where it goes#
Everything goes to one place: the Hisaab website, at the address shown under Website in Settings. The website passes usage statistics to the statistics service and crash reports to the crash-report service that the maker of Hisaab uses (at the time of writing, Umami and GlitchTip).
Usage statistics and crash reports go to that address and to no other. If the website there says it has moved, they still go to the address shown, never to the new one by themselves. Only a check for updates can change the address in use, and Settings then shows the new one. If you save another address, anything still waiting to go to the old one is thrown away, not sent.
Before sending anything, Hisaab asks the website whether it is collecting at all. If the website says no, nothing is sent even when your switches are on, and the line under the switches says so.
Note: Every request over the internet carries your internet (IP) address, and the website passes it on with the message. Statistics services use it to estimate a country. Hisaab adds no identifier of its own, and the request names only the app's version and system, for example Hisaab/0.6.3 (windows; x86_64).
What is sent even with both switches off#
One thing happens by itself: Hisaab looks for a newer version when it starts, and every few hours while it is open. Two small files are downloaded from the website, and the request names only the app's version and system. You can switch this off in Settings, under Updates. See Update Hisaab.
Everything else happens only when you ask for it:
| You do this | What happens |
|---|---|
| Click Check for updates | The same two small files are downloaded from the website |
| Click Download for an update | The installer is downloaded from the website |
| Click Get support or Report a problem | Your browser opens the support form with the version and system in the address |
| Use the AI assistant | Your question and the chat go to the AI service you set up. See the next section |
| Use cloud backup | An encrypted copy goes to the server you set up. See Cloud backup |
With both switches off, the look for a newer version switched off too, and none of the above in use, Hisaab makes no connection to the internet.
What the AI assistant sends#
The assistant talks to the AI service you set up in AI Settings, and to no one else. Nothing goes to the Hisaab website. Each time you ask, this is sent:
| What | When |
|---|---|
| Your question and the earlier messages of the same chat | Always |
| A fixed set of instructions: what the assistant can do, the names of Hisaab's screens and reports, and today's date | Always. They are the same for every company |
| Passages from the documentation built into Hisaab | When the assistant looks something up in the help |
| A short summary of the period on screen | Only when figures shared is on |
The results of the assistant's find and report lookups in your books |
Only when figures shared is on |
| One line for each screen or form the assistant offers, saying that it was offered or that it could not be made | When there is such an offer. The line names things from your books only when figures shared is on |
Nothing else is sent. In particular:
- With figures shared off,
findandreportdo not run, and no name, amount or entry is read from your books for the AI service. Results from earlier in the same chat are left out from then on. - Whether you pressed the button on a card or Not now is not sent.
- A form the assistant filled is not sent, and nothing is saved until you save it yourself.
Remember that your own question, and the assistant's earlier answers, are part of the chat and are sent as they are.
Ask your books lists what the summary and each kind of result hold.
The website address#
Settings shows which website address is in use and why. See Where your data lives for how it is chosen and how to change it.
Next#
Something here wrong or missing? Open a ticket and mention this page.
