veebch/btcticker

这是什么？

核心功能

• 01按可配置的间隔（默认 300 秒）从 CoinGecko 获取价格
• 02支持 CoinGecko 列出的全部币种和法币，可指定交易所价格
• 03通过按键或自动方式在多个币种和法币之间轮换
• 04显示成交量、排名和走势折线图
• 05可选的热门趋势币种模式
• 06以 systemd 服务运行，开机自动启动

适用场景

• 在低功耗墨水屏上常驻显示实时加密货币价格的桌面摆件
• 学习 SPI 显示屏驱动与 systemd 服务的树莓派项目
• 在多种法币下监控少量币种的行情

快速上手

1. 1

   在树莓派上安装所需的系统软件包

   sudo apt-get install -y git python3-venv
2. 2

   克隆 btcticker 仓库

   git clone https://github.com/veebch/btcticker.git
3. 3

   创建虚拟环境并在其中安装 Python 模块

   python3 -m venv --system-site-packages .venv
4. 4

   手动运行行情显示器进行测试

   .venv/bin/python btcticker.py

使用前须知

• !需要树莓派和 Waveshare 2.7 英寸 ePaper 显示屏，依赖特定硬件。
• !脚本默认适配 V1 版 Waveshare 显示屏，使用 V2 版需要修改代码。
• !它依赖 CoinGecko 免费 API 以及完整的树莓派系统。
• !采用 GPL-3.0 许可证，这是一种 copyleft 许可证，要求衍生作品保持开源。

标签

常见问题

btcticker 是什么？

基于树莓派与 2.7 英寸 ePaper 屏幕的加密货币价格桌面显示器，数据来自 CoinGecko。 btcticker 是一个运行在树莓派上的 Python 脚本，配合 Waveshare 2.7 英寸单色 ePaper 屏幕使用。默认每 5 分钟从 CoinGecko 获取价格，并把摘要显示在墨水屏上，适合作为桌面上的被动行情显示器。

btcticker 可以免费使用吗？用的什么许可证？

btcticker 以 GPL-3.0 许可证开源。用于商业产品前，请先确认许可证条款。

btcticker 还在维护吗？

半年内有更新。btcticker 最近一次提交是在 2026年9月29日。

btcticker 适合用来做什么？

在低功耗墨水屏上常驻显示实时加密货币价格的桌面摆件 学习 SPI 显示屏驱动与 systemd 服务的树莓派项目 在多种法币下监控少量币种的行情

btcticker 怎么安装和运行？

在树莓派上安装所需的系统软件包: sudo apt-get install -y git python3-venv 克隆 btcticker 仓库: git clone https://github.com/veebch/btcticker.git 创建虚拟环境并在其中安装 Python 模块: python3 -m venv --system-site-packages .venv 手动运行行情显示器进行测试: .venv/bin/python btcticker.py

在哪里获取 btcticker？

源代码和安装说明在 GitHub 上：https://github.com/veebch/btcticker