-
Notifications
You must be signed in to change notification settings - Fork 6
/
Copy pathsetup_instructions.html
116 lines (104 loc) · 6.5 KB
/
setup_instructions.html
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
<!DOCTYPE html>
<html>
<head>
<title>Visioning Texts, Instructions</title>
<meta name="viewport" contents="width=device-width, initial-scale=1">
<meta name="theme-color" content="#0090EA">
<link rel="icon" type="image/png" href="favicon.png">
<link rel="stylesheet" href="css/stylesheet.css" type="text/css" charset="utf-8"/>
</head>
<body>
<div class="instructions">
<header class="page-title" >
<h1>Visioning Your Own Data: Instructions</h1>
</header>
<nav>
<ol>
<li><a href="index.html">Main Viz page</a></li>
</ol>
</nav>
<section>
<article>
<h2>Whatsapp</h2>
Whatsapp usage is pretty straight forward: just export the chat, then upload that file!
Unfortunately, there are a lot of known issues with date parsing.
The site is primarily tested with "M/DD/YYY HH:mm:ss", i.e. American 24 time format.
Change your phone's settings to the US if things aren't working for you, otherwise feel free to comment on the <a href="https://github.com/BryceStevenWilley/visioning_texts/issues/2">existing issue</a>.
In a Whatsapp conversation, click the top menu, and select "More".
<br/>
<img src="doc/images/whatsapp1.png" alt="WhatsApp conversation settings" height="300" />
<br/>
In the second menu, select "Export Chat".
<br/>
<img src="doc/images/whatsapp2.png" alt="WhatsApp 'More' conversation settings" height="300" />
<br/>
You can then save the chat file anywhere you want: email it to yourself, save it to Google Drive, etc.
Then, upload that same file on the <a href="index.html">main page</a>.
This entire process can be done on mobile (although the website look isn't quite optimized for mobile)!
</article>
</section>
<section>
<article>
<h2>Signal</h2>
<p>This one is a bit complicated, but we'll go through step-by-step.
You'll need access to your Signal app and a computer.
</p>
<ol>
<li><h4>Create a Signal Backup</h4>
<p> In the app, press the menu button and go to Settings.
When in settings, press "Chats and Media".
<br/>
<img src="doc/images/settings_menu.png" alt="the Signal menu screen" height="500" />
<br/>
Scroll to the bottom of the page and turn on "Chat Backups".
<br/>
<img src="doc/images/chat_backup.png" alt="the Signal Chats and Media screen, emphasizing the Chat Backup selection" height="500" />
<br/>
This will start the backup process, which takes several minutes.
<em>Be sure to save the passphrase shown when you first turn on backups.
</em>
</p>
</li>
<li><h4>Download the Backup</h4>
<p>On Android, you can go to the "Files" app.
The backup file will be in the main phone memory, in the Signal folder.
Once there, download the file to your computer.
I usually use Google Drive for this, but pick your poison.
</p>
</li>
<li><h4>Decrypt the Backups</h4>
<p>The best option for this as of early 2020 is <a href="https://github.com/xeals/signal-back">signal-back</a>.
Go to <a href="https://github.com/xeals/signal-back/releases/tag/v0.1.7-alpha.2">the latest release</a>, and download the compiled binary for your system.
MacOS will be "Darwin", and Linux and Windows are named normally.
Once downloaded, open a terminal window, and run the following command:
<code>./signal-back_linux_amd64 format -f CSV -o backup.csv signal-YYYY.backup</code>
replacing "signal-YYYY.backup" with the name of your Signal backup download.
<aside>You might need to make signal-back executable. On Linux, this command is <code>chmod +x signal-back_linux_amd64</code></aside>
This will generate the CSV file that you'll give to the visualizer on the <a href="index.html">main page</a>.
</p>
</li>
<li><h4>Find the Address and the IDs</h4>
<p> When you upload the CSV file to the visualizer, you'll be asked for an "Address", and the names and IDs of the conversation participants.
The names are just to label the data for you to understand better, and aren't used anywhere else.
The address is the Signal CSV's term for "conversation".
IDs are numbers that uniquely identify participants in the conversation.
If you open the CSV file in a spreadsheet app (Excel, for example), you can look around for some conversations that you want to visualize (the message contents will be in the BODY column).
Most conversations will only have 1 ID per participant, but if you switched from text to Signal, or had to regenerate your Signal key, then there might be multiple.
You can enter as many IDs as necessary, comma separated, in the input.
</p>
</li>
</ol>
</article>
</section>
<h3>Run into any issues? None of this make any sense?</h3>
<p>Make an issue <a href="https://github.com/BryceStevenWilley/visioning_texts/issues/new">here</a>, I'll be happy to help/fix it!</p>
<div class="u-container c-footer-container">
<p>© Bryce Willey 2019</p>
<p>
<a href="mailto:[email protected]">[email protected]</a>
<a href="https://github.com/BryceStevenWilley/visioning_texts">Github</a>
</p>
</div>
</div>
</body>
</html>