mirror of
https://github.com/simplex-chat/simplex-chat.git
synced 2025-06-28 20:29:53 +00:00
f97a1fcedf
* website: add fontmatter & improve image URLs where necessary * website: add docs to website * website: add prismjs for code highlighting * website: change npm install position in web.sh * website: fix an image URL in lang/cs/README.md * website: improve image paths in lang/cs/translations.md * website: add responsiveness & improve stylings of docs * website: add dir to navbar in blog & docs * website: remove scroll in mobile dropdown menu * website: remove rfcs & add guide docs to website * website: remove file renaming script from web.sh * website: add menu to docs in nav * website: add hash list & add scroll to headers * website: customize docs frontmatter through JS * website: remove supported_languages.json * website: move merge_translations.js to JS folder * website: add the following changes to docs - add frontmatter to new doc merged from master - add ignoreForWeb property to frontmatter of README.md docs * website: remove package-lock.json from .gitignore * website: add package-lock.json from .gitignore * website: add no docs message to docs dropdown * website: improve the sidebar of docs * website: add revision date to docs * website: add script to add version to docs frontmatter * website: add layout to display message in docs if its version is old * website: improve nav responsiveness * website: remove frontmatter form main README & rfcs * website: remove rfcs from website folder * website: add ignore condition for rfcs in .eleventy * website: remove frontmatter from lang README docs * website: remove README from website's lang docs * website: add guides menu in nav * website: following changes - add docs_dropdown.json - extend reference menu in nav - remove docs menu from nav * website: fix in docs sidebar * website: revert main docs README.md files * website: revert main docs README.md files * website: move scripts out of js that are for build * website: remove displayAt form guide docs * website: create a docs_sidebar.json & shift to that approach * update navigation * website: set navbar * website: add icons to external links * website: change the approach for docs sidebar creation * website: update docs template * website: add some strings to en.json and map them accordingly * remove icon --------- Co-authored-by: Evgeny Poberezkin <2769109+epoberezkin@users.noreply.github.com>
60 lines
2.2 KiB
Markdown
60 lines
2.2 KiB
Markdown
---
|
|
title: Accessing messages in the database
|
|
revision: 31.01.2023
|
|
---
|
|
|
|
| Updated 31.01.2023 | Languages: EN, [FR](/docs/lang/fr/SQL.md), [CZ](/docs/lang/cs/SQL.md) |
|
|
|
|
# Accessing messages in the database
|
|
|
|
## Decrypting databases
|
|
|
|
In order to view database data you need to decrypt it first. Install `sqlcipher` using your favorite package manager and run the following commands in the directory with databases:
|
|
```bash
|
|
sqlcipher files_chat.db
|
|
pragma key="youDecryptionPassphrase";
|
|
# Ensure it works fine
|
|
select * from users;
|
|
```
|
|
|
|
If you see `Parse error: no such table: users`, make sure you entered correct passphrase, and you have changed passphrase from random in Android app (if you got this database from Android device, of course).
|
|
|
|
## SQL queries
|
|
|
|
You can run queries against `direct_messages`, `group_messages` and `all_messages` (or their simpler alternatives `direct_messages_plain`, `group_messages_plain` and `all_messages_plain`), for example:
|
|
|
|
```sql
|
|
-- you can put these or your preferred settings into ~/.sqliterc
|
|
-- to persist across sqlite3 client sessions
|
|
.mode column
|
|
.headers on
|
|
.nullvalue NULL
|
|
|
|
-- simple views into direct, group and all_messages
|
|
-- with user's messages deduplicated for group and all_messages;
|
|
-- only 'x.msg.new' ("new message") chat events - filters out service events;
|
|
-- msg_sent is 0 for received, 1 for sent
|
|
select * from direct_messages_plain;
|
|
select * from group_messages_plain;
|
|
select * from all_messages_plain;
|
|
|
|
-- query other details of your chat history with regular SQL, for example:
|
|
-- files you offered for sending
|
|
select * from direct_messages where msg_sent = 1 and chat_msg_event = 'x.file';
|
|
-- everything catherine sent related to cats
|
|
select * from direct_messages where msg_sent = 0 and contact = 'catherine' and msg_body like '%cats%';
|
|
-- all correspondence with alice in #team
|
|
select * from group_messages where group_name = 'team' and contact = 'alice';
|
|
|
|
-- aggregate your chat data
|
|
select contact_or_group, num_messages from (
|
|
select
|
|
contact as contact_or_group, count(1) as num_messages
|
|
from direct_messages_plain group by contact
|
|
union
|
|
select
|
|
group_name as contact_or_group, count(1) as num_messages
|
|
from group_messages_plain group by group_name
|
|
)
|
|
order by num_messages desc;
|
|
```
|