Skip to main content

Goldteeth

Flake8 Lint PyPI version

Monitors crypto/stock prices & volatility and plays an alert sound when a target is reached.

  • It will also send a desktop notification on Linux or MAC OSX.
  • Run via python in a terminal or use the optional GUI.

Table of Contents

Usage

python src/goldteeth_cli.py <symbol> <mode> <target> <wav>

Price Targets

python src/goldteeth_cli.py btc above 100000 src/goldteeth/alert.wav
python src/goldteeth_cli.py eth below 3000 src/goldteeth/alert.wav

Volatility

python src/goldteeth_cli.py sol vol 10-5 src/goldteeth/alert.wav  # 10% move in 5 mins
python src/goldteeth_cli.py doge vol 5-15 src/goldteeth/alert.wav  # 5% move in 15 mins
python src/goldteeth_cli.py tsla vol 5-10 src/goldteeth/alert.wav  # 5% move in 10 mins

Stocks

  • Requires a Finnhub API key (free, email sign-up)
export FINNHUB_API_KEY="your_key_here"
python src/goldteeth_cli.py tsla above 400 src/goldteeth/alert.wav

Limitations

  • With the free API key Finnhub still limits you to one websocket connection.
  • Goldteeth tries to work around this with recovery loops and HTTP fallback and will keep trying if using multiple instances.
  • If you see this error it's due to free API limits, if you have a paid API key then you shouldn't see limits.
WebSocket error: Connection to remote host was lost.
WebSocket closed

Configuration

  • Modify CRYPTO_INTERVAL to adjust crypto polling frequency (default: 60s)
  • Modify STOCK_INTERVAL to adjust stock ticker polling frequency (default: 120s)
  • Modify SHOW_WS_ERRORS to show/hide websocket errors for stocks (default: False)

Requirements

  • Python 3 with these libraries:
    • requests or python3-requests
    • pytz or python3-pytz (stocks only)
    • websockets or python3-websockets (stocks only)
  • mpv or mplayer (audio alerts)

GUI

  • Right now the GUI is not available via pip install
python src/goldteeth_gui.py

Installation

  • There are two ways to Goldteeth:
    • Clone repositry and run (ensure Python libraries are present)
    • pip install

Installation via Pip

python -m venv goldteeth
. !$/bin/activate
pip install goldteeth

Usage with Pip

  • alert.wav is included but you can pass your own audio file.
goldteeth btc below 88000

Installation via Repository

git clone https://github.com/sadsfae/goldteeth.git
cd goldteeth

Run from Repository

python src/goldteeth_cli.py tsla below 400 src/goldteeth/alert.wav
python src/goldteeth_cli.py btc vol 5-60 src/goldteeth/alert.wav

GUI Installation via Repository

  • First make sure you have the repository cloned.
  • Be inside the repository directory.

Generate GUI Desktop Shortcut

cat > goldteeth.desktop <<EOF
[Desktop Entry]
Version=1.0
Name=Goldteeth
Comment=Monitor crypto and stock prices
Exec=$(which python3) $(pwd)/src/goldteeth_gui.py
Path=$(pwd)/
Icon=utilities-system-monitor
Terminal=false
Type=Application
Categories=Utility;Finance;
EOF

Copy GUI Desktop Shortcut

mkdir -p ~/.local/share/applications/
mv goldteeth.desktop ~/.local/share/applications/
chmod +x ~/.local/share/applications/goldteeth.desktop
update-desktop-database ~/.local/share/applications/
  • Goldteeth should now appear in your Applications menu in your favorite Desktop Environment.

Screenshots

CLI

goldteeth Mon

goldteeth Vol

GUI

goldteeth GUI

Metadata

Release files for goldteeth 1.4.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for goldteeth 1.4.1
File Size Uploaded Provenance Actions
goldteeth-1.4.1.tar.gz 54.7 kB Without provenance Details for goldteeth-1.4.1.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for goldteeth 1.4.1
File Interpreter ABI Platform Actions
goldteeth-1.4.1-py3-none-any.whl Python 3 none any Details for goldteeth-1.4.1-py3-none-any.whl

Total release size: 94.6 kB

Release files / goldteeth-1.4.1.tar.gz

Download URL goldteeth-1.4.1.tar.gz
Size 54.7 kB
Tags Source
SHA-256 checksum
How to use checksums
56ecf2655d69055d5aece5cca685a8aaa843e708fafab486ce2d1adfec724ce0
BLAKE2b-256 checksum
How to use checksums
63ac8c7198de65338cbb33018451492ea9940e8ecc40c4dca1ceb5bf3f2ed4ee
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.13.16

Release files / goldteeth-1.4.1-py3-none-any.whl

Download URL goldteeth-1.4.1-py3-none-any.whl
Size 39.9 kB
Tags Python 3
SHA-256 checksum
How to use checksums
eac4d6af82fb1cb4510eb3fa406673e99b5aee68e30a14e6eb2ab5c1d8539a0e
BLAKE2b-256 checksum
How to use checksums
75119daf55db557808de58cb7d268e90890c54ca9cf4e4fdd90c9a00ade50fdb
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.13.16

Security for goldteeth 1.4.1

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page