{"id":22493576,"url":"https://github.com/bigsk1/matrix-crypto","last_synced_at":"2026-02-18T07:02:26.619Z","repository":{"id":220754170,"uuid":"752508256","full_name":"bigsk1/matrix-crypto","owner":"bigsk1","description":"Matrix Crypto is a terminal application that provides real time prices of cryptocurrency information in a matrix-style animation. Think cmatrix but with crypto! ","archived":false,"fork":false,"pushed_at":"2024-11-27T13:03:41.000Z","size":223,"stargazers_count":2,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-02-12T09:44:59.392Z","etag":null,"topics":["background","bitcoin","cli","cmatrix","coingecko","coingecko-api","coingeckoapi","curses","ethereum","linux","matrix","python","screensaver","solana","terminal-app","terminal-based","windows"],"latest_commit_sha":null,"homepage":"https://bigsk1.com/posts/Matrix-Crypto/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/bigsk1.png","metadata":{"files":{"readme":"README.MD","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null},"funding":{"github":"bigsk1"}},"created_at":"2024-02-04T03:26:23.000Z","updated_at":"2025-03-31T21:15:40.000Z","dependencies_parsed_at":"2024-11-27T13:28:11.604Z","dependency_job_id":"603f9654-929e-4cbe-8bb9-bc2e7b430cd1","html_url":"https://github.com/bigsk1/matrix-crypto","commit_stats":null,"previous_names":["bigsk1/matrix-crypto"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/bigsk1/matrix-crypto","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bigsk1%2Fmatrix-crypto","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bigsk1%2Fmatrix-crypto/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bigsk1%2Fmatrix-crypto/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bigsk1%2Fmatrix-crypto/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/bigsk1","download_url":"https://codeload.github.com/bigsk1/matrix-crypto/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bigsk1%2Fmatrix-crypto/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29571888,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-18T06:19:27.422Z","status":"ssl_error","status_checked_at":"2026-02-18T06:18:44.348Z","response_time":162,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["background","bitcoin","cli","cmatrix","coingecko","coingecko-api","coingeckoapi","curses","ethereum","linux","matrix","python","screensaver","solana","terminal-app","terminal-based","windows"],"created_at":"2024-12-06T18:54:43.352Z","updated_at":"2026-02-18T07:02:26.603Z","avatar_url":"https://github.com/bigsk1.png","language":"Python","funding_links":["https://github.com/sponsors/bigsk1"],"categories":[],"sub_categories":[],"readme":"\n## Matrix Crypto Terminal Display 💻\n\nThe Matrix Crypto Display is a Python-based terminal application that provides a visually appealing display of cryptocurrency information in a matrix-style animation. This project offers two main functionalities: one version displays real-time cryptocurrency prices, and another displays cryptocurrency names without prices for a simplified, aesthetic experience. \n\n### Think cmatrix but with crypto prices! \n\n### Features\n\n- Real-time Price Updates: Fetch and display the latest cryptocurrency prices in real-time. Uses coingecko public api to get prices every 90 seconds.\n- Cryptocurrency Name Display: A no-prices version that focuses on displaying the names of cryptocurrencies.\n- Customizable Display: Users can customize the display speed and color to suit their preferences.\n- Flexible Configuration: Easy configuration through JSON files to specify which cryptocurrencies to display.\n- Command-line Options: Includes options for adjusting display settings directly through command-line arguments.\n- Custom scripts for getting the latest crypto ecosystem lists, Top 20 Solana or Ethereum tokens.\n\nhttps://github.com/user-attachments/assets/c31a7eb0-71de-4e42-a569-c9b99a368136\n\n\n\n## Windows and Linux Terminal using Python 3.8 +\n\nDownload python if you don't already have it\n[Python Download](https://www.python.org/downloads/release/python-3117/)\n\n\nIs best run on linux terminal as window curses seems to be lacking some features but still works. \n\n\n## Installation\n\nClone the Repository\n\n```bash\ngit clone https://github.com/bigsk1/matrix-crypto.git\ncd matrix-crypto\n```\n\n## Quick start\n\n### Windows\n\nDouble click the run_windows.bat file\n\nIf having trouble, Windows users might need to manually download and use Miniconda with python=3.11.4 and run:\n\n```bash\npip install -r requirements.txt\n```\n\n### Linux/MacOS\n\n```bash\nchmod +x run_linux.sh \u0026\u0026 ./run_linux.sh\n```\n\nIf you have trouble running then run:\n\n```bash\nsed -i 's/\\r$//' ./run_linux.sh\n```\n\nAnd try again:\n\n```bash\n./run_linux.sh\n```\n\n## Manual Install\n\nCreate and Activate a Virtual Environment (Optional but Recommended)\n\n```bash\npython -m venv venv\nsource venv/bin/activate  # On Windows use `venv\\Scripts\\activate`\n```\n\nInstall Required Packages\n\n```bash\npip install -r requirements.txt\n```\n\n## Usage\n\n```bash\npython matrix_crypto.py\n```\nCTL+C to Exit\n\n\n### Add to bashrc or zshrc ( optional for linux )\n\nWant to type matrixc and start the script? cmatrix but for crypto!!!\n\nEnsure your script is executable. Navigate to the directory where your matrix_crypto.py script is located and run:\n\n```bash\nchmod +x matrix_crypto.py\n```\n\nOpen your .zshrc or .bashrc file in a text editor and update your path:\n\n```bash\nalias matrixc='cd /path/to/matrix-crypto \u0026\u0026 python matrix_crypto.py'\n```\n\nReplace /path/to/matrix-crypto/matrix_crypto.py with the actual path to your script. \n\n```bash\nsource ~/.zshrc\n```\n\nNow you can run your script from anywhere in the terminal by typing:\n\n```bash\nmatrixc\n```\n\n\n## Advanced Usage\n\nRun the application:\n\n```bash\npython matrix_crypto.py [--bg-color BG_COLOR] [--crypto-color CRYPTO_COLOR] [--solana] [--eth]\n```\n\nCommand-line Options\n\n- --bg-color: Adjust the color of the falling background text (e.g., green, red, blue).\n- --crypto-color: Choose the color of the crypto tickers (e.g., white, yellow, cyan).\n- --solana, --eth: Use a specific cryptocurrency list (e.g., Solana or Ethereum ecosystems).\n\nExample:\n\n```bash\npython matrix_crypto.py --bg-color red --crypto-color yellow --eth\n```\n\n## Update crypto ecosystem list\n\nUse the prefilled crypto_list.json or modify and add your own tickers.\n(Optional) You can run any of the .py files to get the current list of Solana or Ethereum top 20 to populate the .json config, which is to get token IDs and names for prices. Only really need to run once in a while if you want a fresh list. I would remove stable coins like USDC and USDT.\n\n- `python crypto_list.py`: Gets top 20 overall cryptos by market cap (default list of cryptos).\n- `python solana_crypto_list.py`: Gets top 20 Solana tokens by market cap.\n- `python ethereum_crypto_list.py`: Gets top 20 Ethereum tokens by market cap.\n\n## Configuration\n\nEdit the `crypto_list.json` file for the name display version or the respective ecosystem files (e.g., `solana_ecosystem_crypto_list.json`) for the price display version to customize which cryptocurrencies are shown.\n\nExample configuration for name display:\n\n```json\n{\n    \"cryptos\": [\n        {\n            \"id\": \"bitcoin\",\n            \"ticker\": \"BTC\",\n            \"name\": \"Bitcoin\"\n        },\n        {\n            \"id\": \"ethereum\",\n            \"ticker\": \"ETH\",\n            \"name\": \"Ethereum\"\n        }\n    ]\n}\n```\n\nCustomizing the Cryptocurrency List\n\nTo modify the list of displayed cryptocurrencies, edit the appropriate .json configuration file by adding or removing entries under the \"cryptos\" key.\n\n## Settings changes \n\nYou can directly change settings in the maxtrix_crypto.py file to fine tune the look your after! \n\n```python\n# User-configurable settings\nSETTINGS = {\n    'ANIMATION_SPEED': 0.01,  # Lower is faster, higher is slower. This is the delay between frames in seconds.\n    'BACKGROUND_PATTERN': [1, 2, 3, 2],  # Gap widths pattern.\n    'BACKGROUND_CHARS': 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789!@#$%^\u0026*()_+-=[]{}|;:,.\u003c\u003e?/',\n    'CRYPTO_DISPLAY_COUNT': 4,  # Maximum number of crypto prices displayed simultaneously.\n    'CRYPTO_DISPLAY_CHANCE': 0.1,  # Chance of new crypto display appearing each frame.\n    'FADE_LENGTH': 0,  # Length of fade effect at top and bottom in number of characters.\n    'BACKGROUND_INTENSITY_LEVELS': 3,  # Number of intensity levels for background.\n    'CRYPTO_FALL_SPEED_RANGE': (0.1, 0.2),  # Min and max fall speed for crypto displays in seconds.\n    'BACKGROUND_CHANGE_CHANCE': 0.2,  # Chance of a background character changing each update.\n    'BACKGROUND_FALL_SPEED_RANGE': (0.06, 0.1),  # Min and max fall speed for background characters in seconds.\n    'BACKGROUND_COLUMN_LENGTH_RANGE': (0.3, 0.7),  # Min and max length of background columns as a fraction of screen height.\n    'BACKGROUND_COLUMN_GAP_RANGE': (0.2, 0.3),  # Min and max gap between columns as a fraction of screen height.\n    'LEAD_CHAR_COLOR': curses.COLOR_WHITE,  # Color of the leading character in each column.\n    'LEAD_CHAR_CHANCE': 1,  # Chance of a new leading character appearing when the column updates.\n    'CRYPTO_COLOR': 'white',  # Default color for crypto tickers\n}\n```\n\n\n## Logging\n\nThe application generates a log file (matrix_crypto.log) to store runtime information, errors, and other log messages. The log is rotated every 10 days to prevent excessive file size.\n\n## Cryptocurrency Name Display Only\n\nRun the simplified version that displays only cryptocurrency names under the `offline-version-no-prices` folder:\n\n```bash\npython matrix_crypto.py [--bg-color BG_COLOR] [--crypto-color CRYPTO_COLOR]\n```\n\n\n---\n\n\n\n## Sample Command-Line Combinations\n\nBelow are some sample command-line combinations you can use to run the `matrix_crypto.py` script with various options. Each command is provided in a code block for easy copying.\n\n### Default Run (without any arguments)\n```bash\npython matrix_crypto.py\n```\n\n### Custom Background Color\n\n- Green background (default)\n```bash\npython matrix_crypto.py --bg-color green\n```\n\n- Red background\n```bash\npython matrix_crypto.py --bg-color red\n```\n\n- Blue background\n```bash\npython matrix_crypto.py --bg-color blue\n```\n\n- Yellow background\n```bash\npython matrix_crypto.py --bg-color yellow\n```\n\n### Custom Crypto Ticker Color\n\n- White ticker (default)\n```bash\npython matrix_crypto.py --crypto-color white\n```\n\n- Yellow ticker\n```bash\npython matrix_crypto.py --crypto-color yellow\n```\n\n- Cyan ticker\n```bash\npython matrix_crypto.py --crypto-color cyan\n```\n\n- Magenta ticker\n```bash\npython matrix_crypto.py --crypto-color magenta\n```\n\n### Using Different Crypto Lists\n\n- Use Solana ecosystem crypto list\n```bash\npython matrix_crypto.py --solana\n```\n\n- Use Ethereum ecosystem crypto list\n```bash\npython matrix_crypto.py --eth\n```\n\n### Combination of Arguments\n\n- Red background with yellow ticker and Solana crypto list\n```bash\npython matrix_crypto.py --bg-color red --crypto-color yellow --solana\n```\n\n- Blue background with cyan ticker and Ethereum crypto list\n```bash\npython matrix_crypto.py --bg-color blue --crypto-color cyan --eth\n```\n\n- Green background with magenta ticker and Solana crypto list\n```bash\npython matrix_crypto.py --bg-color green --crypto-color magenta --solana\n```\n\n### Additional Custom Combinations\n\n- Yellow background with white ticker\n```bash\npython matrix_crypto.py --bg-color yellow --crypto-color white\n```\n\n- Cyan background with red ticker\n```bash\npython matrix_crypto.py --bg-color cyan --crypto-color red\n```\n\n- Magenta background with blue ticker\n```bash\npython matrix_crypto.py --bg-color magenta --crypto-color blue\n```\n\n![matrix-crypto](/img/matrix.png)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbigsk1%2Fmatrix-crypto","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbigsk1%2Fmatrix-crypto","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbigsk1%2Fmatrix-crypto/lists"}