-
-
Notifications
You must be signed in to change notification settings - Fork 10
/
README.txt
249 lines (101 loc) · 9.04 KB
/
README.txt
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
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
Copyright 2019-2024 GPLv3, Slideshow Crypto Ticker by Mike Kilday: [email protected] (leave this copyright / attribution intact in ALL forks / copies!)
Open source / 100% FREE real time slideshow crypto price ticker for Raspberry Pi LCD screens, including 24 hour volume and CoinGecko / Binance / Coinbase Pro / Kraken / Kucoin / Bitstamp / Bitfinex / HitBTC / OKex / Gate.io support (more market support coming in the future).
NOTES FOR BLACKHATS:
P̵̫̊h̴̪̑ì̶̯s̵̫̀h̸̠̆i̶̔͜n̸̞͒g̶̳̏ ̸̺͐a̴͎̓n̷̜̕d̴̻͆ ̵̙̕b̶͓͝ř̵̗u̵̼̔t̷͖͐e̴̢͑ ̵̦͊f̸̱̃ö̶̦́r̷͉͌c̴̍͜ê̸͈ ̶̬̍l̴̙̾ō̸̗g̵̫̿ḯ̴̱ṅ̸̖ ̴̘́/̴̣̅ ̸̳̈d̶̡̃ẹ̶̈c̸̲͂r̶̰̋ỹ̵̨p̶̥͂t̷͍̎i̶̮̕o̸̝̎n̸̟͑ ̴͎͑/̶̹̑ ̶͉̎O̵̦̿T̵̜̄H̶̗̓Ę̶͗R̸̪̋ ̸̦̾ȃ̷̰t̸̪̂ṯ̸̐ä̶͈́c̸̫̈k̶͈̍s̴̳̀ ̸͇̎w̸̢͝i̶͕̍l̵̦͗l̵̗̽ ̷̱̀Ň̴͍Ō̶͓T̶̙́ ̸̺̆w̶̖̓o̸̠͝r̴̪̃k̵̞͠ ̴̪̎o̴͎̽n̸͎͘ ̸̗͘m̴̖͗ẽ̸̠,̴̨̆ ̴͙̇G̵̬̿Ĭ̴͍V̶͉̇E̸̳̐ ̴̯̾U̸̺͂P̶̩̀ ̴̨͌A̵͋͜L̴̤̎R̷̖͘Ē̸͕Â̸͍D̸̨̒Ÿ̶͜!̶͖͛
GITHUB SECURITY NOTICE:
As of 2024/11/02, I am signing EVERY GITHUB CODE COMMIT with my GPG key. For verification, see the file: taoteh1221-gpg-pub-key.asc (in the app main directory)
Supports running in "slideshow mode", to show all the markets you want.
Example on a 3.5" LCD: https://www.youtube.com/watch?v=dXAhs8HXCn4
Example on a 7" LCD: https://www.youtube.com/watch?v=fZ98Fm6ZkW8
Developed on a Raspi v3 B+, with these screens / cases:
https://amazon.com/gp/product/B07N38B86S (stock, no mods)
https://amazon.com/gp/product/B08Q34RS7M
(Noctua fan mounted with crazy glue, and Noctua fan speed controller outside case)
https://amazon.com/gp/product/B07DXRNYNX
https://amazon.com/gp/product/B072M2HKSN
Project Website: https://sourceforge.net/projects/dfd-crypto-ticker
Download Latest Version: https://github.com/taoteh1221/Slideshow_Crypto_Ticker/releases
Issue Reporting (Features / Issues / Help): https://github.com/taoteh1221/Slideshow_Crypto_Ticker/issues
Discord: https://discord.gg/WZVK2nm
Telegram: https://t.me/dragonfrugal
Twitter: https://twitter.com/taoteh1221
Private Contact: https://dragonfrugal.com/contact
Donations support further development...
Bitcoin: 3Nw6cvSgnLEFmQ1V4e8RSBG23G7pDjF3hW
Ethereum: 0x644343e8D0A4cF33eee3E54fE5d5B8BFD0285EF8
Solana: GvX4AU4V9atTBof9dT9oBnLPmPiz3mhoXBdqcxyRuQnU
Github Sponsors: https://github.com/sponsors/taoteh1221
Patreon: https://www.patreon.com/dragonfrugal
PayPal: https://www.paypal.me/dragonfrugal
Venmo: https://account.venmo.com/u/taoteh1221
#############################################################################################
SINGLE TICKER *MINIMUM* system specs:
1 Gigahertz CPU / 512 Megabytes RAM / HIGH QUALITY 16 Gigabyte MicroSD card
MUTIPLE TICKERS (slideshow mode) *MINIMUM* system specs:
4 cores (1 Gigahertz each) CPU / 1 Gigabyte RAM / HIGH QUALITY 16 Gigabyte MicroSD card
#############################################################################################
AUTOMATIC INSTALLATION / UPGRADING
IMPORTANT NOTES: This install script has been designed to run generically on Debian-based systems, but has only been tested on RaspberryPi / DietPi operating systems. For Ticker autostart at system boot, the LXDE Desktop is #REQUIRED# (this is the default desktop on RaspberryPi OS). The ticker can also be manually started (see CONFIGURING AFTER INSTALLATION).
To install / upgrade everything automatically on a RaspberryPi / DietPi device, copy => paste => run the command below in a terminal program (using the 'Terminal' app in the system menu, or over remote SSH), while logged in AS THE USER THAT WILL RUN THE APP (user must have sudo privileges):
wget --no-cache -O TICKER-INSTALL.bash https://tinyurl.com/install-crypto-ticker;chmod +x TICKER-INSTALL.bash;sudo ./TICKER-INSTALL.bash
Follow the prompts, and the automated script will install / upgrade / configure the ticker. KUCOIN MARKETS #WILL NOT WORK# IF YOU DO NOT INSTALL THE TICKER PROPERLY!
#############################################################################################
CONFIGURING AFTER INSTALLATION
Edit the following file in a text editor to switch between different exchanges / crypto assets / base pairings, and to configure settings for slideshow speed / font sizes and colors / background color / vertical position / screen orientation / google font used / monospace emulation:
/home/YOUR_USER_NAME/slideshow-crypto-ticker/config.js
Example editing config.js in nano by command-line:
nano ~/slideshow-crypto-ticker/config.js
After updating config.js, restart the ticker with this command:
~/ticker-restart
If autostart does not work / is not setup, you can run this command MANUALLY, #AFTER BOOTING INTO THE DESKTOP INTERFACE#, to start Slideshow Crypto Ticker:
~/ticker-start
If you prefer chromium, epiphany, or firefox (firefox is recommended for long term reliability):
~/ticker-start chromium
~/ticker-start epiphany
~/ticker-start firefox
To stop Slideshow Crypto Ticker:
~/ticker-stop
If you have a "goodtft LCD-show" LCD screen and you installed it's drivers, you can now switch between the LCD and your normal monitor by running the command:
~/goodtft-only
#############################################################################################
MANUAL INSTALLATION (IF AUTO-INSTALL SCRIPT FAILS, ETC)...
SUBSTITUTE "YOUR_USER_NAME" FOR THE USERNAME YOU LOGIN AS ON YOUR SYSTEM.
IMPORTANT NOTES: USE A #FULL# DESKTOP, #NOT# LITE, OR YOU LIKELY WILL HAVE SOME ISSUES EVEN AFTER UPGRADING TO GUI (trust me). If your system is NOT RaspberryPi OS, or you are logged in / running as a user other than 'pi', just substitute that username in place of the 'YOUR_USER_NAME' user in references below.
UPGRADE NOTES: For v2.13.0 and higher, delete any OLDER install's /scripts/ and /apps/ sub-directories WITHIN the main 'slideshow-crypto-ticker' directory (THESE ARE NO LONGER USED).
Create a new directory / folder named 'slideshow-crypto-ticker' in /home/YOUR_USER_NAME/ on your RaspberryPi / DietPi device,
and put all the app's files and folders into this directory.
---------------------
Run these commands (logged in as user YOUR_USER_NAME):
sudo apt-get update && sudo apt-get upgrade
sudo apt-get install xdotool unclutter sed -y
chmod -R 755 ~/slideshow-crypto-ticker/bash
ln -s ~/slideshow-crypto-ticker/bash/ticker-restart.bash ~/ticker-restart
ln -s ~/slideshow-crypto-ticker/bash/ticker-start.bash ~/ticker-start
ln -s ~/slideshow-crypto-ticker/bash/ticker-stop.bash ~/ticker-stop
---------------------
Create / edit the following autostart file (create any directories that don't exist yet): /home/YOUR_USER_NAME/.config/lxsession/LXDE_PROFILE_NAME/autostart and add the following (firefox can be changed to epiphany, or chromium if desired, but firefox is usually the most reliable)...
IMPORTANT: SUBSTITUTE "LXDE_PROFILE_NAME" FOR THE LXDE PROFILE NAME USED FOR YOUR LXDE SESSION (whatever the sub-folder name is INSIDE: /home/YOUR_USER_NAME/.config/lxpanel, on raspberry pi os it is: LXDE-pi, default if unknown should be: LXDE).
FIRST, IF THE FILE DOES #NOT# EXIST YET, we need to copy the SYSTEM defaults over with this command:
cp /etc/xdg/lxsession/LXDE_PROFILE_NAME/autostart /home/pi/.config/lxsession/LXDE_PROFILE_NAME/
NEXT, we add the ticker autostart command at the end of the autostart file:
@/home/YOUR_USER_NAME/slideshow-crypto-ticker/bash/lxde-auto-start.bash firefox
After creating the LXDE Desktop autostart file above, the ticker will run on system startup when you login / auto-login to the LXDE Desktop.
---------------------
Add this as a cron job every minute, by creating the following file (you'll need sudo/root permissions): /etc/cron.d/ticker and add the following line (and a carriage return AFTER it to be safe):
* * * * * YOUR_USER_NAME /bin/bash /home/YOUR_USER_NAME/slideshow-crypto-ticker/bash/cron/cron.bash > /dev/null 2>&1
If your system DOES NOT have /etc/cron.d/ on it, then NEARLY the same format (minus the username) can be installed via the 'crontab -e' command (logged in as the user you want running the cron job):
* * * * * /bin/bash /home/YOUR_USER_NAME/slideshow-crypto-ticker/bash/cron/cron.bash > /dev/null 2>&1
IMPORTANT CRON JOB NOTES: MAKE SURE YOU ONLY USE EITHER /etc/cron.d/, or 'crontab -e', NOT BOTH...ANY OLD DUPLICATE ENTRIES WILL RUN YOUR CRON JOB TOO OFTEN.
---------------------
When you've finished setting up everything, reboot to activate the ticker with this command:
sudo reboot
## ONLY RUN BELOW COMMANDS IF YOU HAVE A "goodtft LCD-show" LCD screen:
sudo apt-get update && sudo apt-get upgrade
sudo apt install git
cd ~/slideshow-crypto-ticker/builds
git clone https://github.com/goodtft/LCD-show.git
cd ~/
chmod -R 755 ~/slideshow-crypto-ticker/builds
ln -s ~/slideshow-crypto-ticker/bash/goodtft-only.bash ~/goodtft-only
#############################################################################################
See TROUBLESHOOTING.txt for additional tips / troubleshooting FAQs.