Real Time Slideshow Crypto Price Ticker For Raspberry Pi LCD Screens
Copyright 2019-2025 GPLv3, Slideshow Crypto Ticker by Mike Kilday: Mike@DragonFrugal.com (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/SlideshowCryptoTicker/releases
Issue Reporting (Features / Issues / Help): https://github.com/taoteh1221/SlideshowCryptoTicker/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/YOURUSERNAME/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 NOT using x11 as a DISPLAY MANAGER, you can OPTIONALLY include which browser to reload with:
~/ticker-restart chromium
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 (chromium 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 "YOURUSERNAME" 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 'YOURUSERNAME' 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/YOURUSERNAME/ on your RaspberryPi / DietPi device, and put all the app's files and folders into this directory.
Run these commands (logged in as user YOURUSERNAME):
sudo apt-get update && sudo apt-get upgrade
sudo apt-get install xdotool 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 one of the following autostart files (depending if you are running LXDE Desktop, OR [modern raspi os] wayland-based labwc Desktop...create any directories that don't exist yet)...
LXDE:
/home/YOURUSERNAME/.config/lxsession/LXDEPROFILENAME/autostart
IMPORTANT: SUBSTITUTE "LXDEPROFILENAME" FOR THE LXDE PROFILE NAME USED FOR YOUR LXDE SESSION (whatever the sub-folder name is INSIDE: /home/YOURUSERNAME/.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 (OR YOU MAY CRASH YOUR DESKTOP!):
cp /etc/xdg/lxsession/LXDEPROFILENAME/autostart /home/pi/.config/lxsession/LXDEPROFILENAME/
NEXT, we add the ticker autostart command at the end of the autostart file:
@/home/YOURUSERNAME/slideshow-crypto-ticker/bash/bootup-auto-start.bash chromium
Wayland/labwc:
/home/YOURUSERNAME/.config/labwc/autostart
Create a blank file, if it does not already exist.
NEXT, we add the ticker autostart command at the end of the autostart file:
bash /home/YOURUSERNAME/slideshow-crypto-ticker/bash/bootup-auto-start.bash chromium 2>&1 &
IMPORTANT NOTE ON ABOVE CONFIGS:
After creating the appropriate autostart file above, the ticker will run on system startup when you login / auto-login to the Desktop. Chromium can be changed to epiphany or firefox if desired, but chromium is USUALLY the most reliable.
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):
* YOURUSERNAME /bin/bash /home/YOURUSERNAME/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/YOURUSERNAME/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.