{"id":30085483,"url":"https://github.com/harmony-one/harmony-tui","last_synced_at":"2025-08-09T00:53:32.158Z","repository":{"id":35239497,"uuid":"213987812","full_name":"harmony-one/harmony-tui","owner":"harmony-one","description":"Text based user interface for Harmony node","archived":false,"fork":false,"pushed_at":"2022-03-21T19:23:48.000Z","size":19330,"stargazers_count":7,"open_issues_count":6,"forks_count":2,"subscribers_count":24,"default_branch":"master","last_synced_at":"2025-05-12T13:05:20.579Z","etag":null,"topics":["harmony","tui"],"latest_commit_sha":null,"homepage":"","language":"Go","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/harmony-one.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2019-10-09T17:58:55.000Z","updated_at":"2022-12-02T01:22:10.000Z","dependencies_parsed_at":"2022-08-08T07:00:18.656Z","dependency_job_id":null,"html_url":"https://github.com/harmony-one/harmony-tui","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/harmony-one/harmony-tui","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/harmony-one%2Fharmony-tui","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/harmony-one%2Fharmony-tui/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/harmony-one%2Fharmony-tui/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/harmony-one%2Fharmony-tui/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/harmony-one","download_url":"https://codeload.github.com/harmony-one/harmony-tui/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/harmony-one%2Fharmony-tui/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":269513785,"owners_count":24429743,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-08-08T02:00:09.200Z","response_time":72,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":["harmony","tui"],"created_at":"2025-08-09T00:53:23.198Z","updated_at":"2025-08-09T00:53:32.118Z","avatar_url":"https://github.com/harmony-one.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Harmony-TUI\nText based user interface for Harmony node.\nBelow information is currently displayed on Harmony-TUI\n1. Section - Harmony Blockchain\n    - Connected peers\n    - Leader's one address\n    - Current epoch number\n    - Recent timestamps of various stages\n2. Section - Harmony Node\n    - Harmony node binary version\n    - ShardId of local node\n    - Balance of user's one account\n3. Section - Current Block\n    - Current block number\n    - Size of current block in bytes\n    - Hash of current block\n    - StateRoot\n    - BlockEpoch\n    - Number of signers who signed last block\n4. Section - System Stats\n    - CPU usage in percentage\n    - Memory/RAM usage of system\n    - Used disk space\n5. Section - Validator Logs\n    - This section shows validator log file\n\n# Dependencies\n1. harmony node running on localhost:9000\n2. shared libraries required for running harmony node\n3. Harmony TUI binary should be in same directory as harmony node binary\n# Build and run harmony-tui binary\n### Build from source code\n1. Clone repository - `git clone git@github.com:harmony-one/harmony-tui.git`\n2. `cd harmony-tui`\n3. Invoke `make` to build harmony-tui binary for local platform or `make build-linux` for linux\n4. binary will get generated in `./bin` directory\n5. Copy harmony-tui binary from ./bin to the same directory as harmony node binary\n6. Invoke binary - `path_to_binary/harmony-tui --address=YOUR_ONE_ADDRESS`\n### Download binary and run .\n1. Download binary directly for here(TODO: add hyperlink).\n2. Place downloaded binary in same directory as harmony node binary\n3. Invoke binary - `path_to_binary/harmony-tui --address=YOUR_ONE_ADDRESS`\n# Usage\n1. Invoke binary - `path_to_binary/harmony-tui --address=YOUR_ONE_ADDRESS`\n2. Help information - `path_to_binary/harmony-tui--help`\n3. Command line arguments supported by harmony-tui binary\n```\n  -address string\n        address of your one account (default \"Not Provided\")\n  -config string\n        path to configuration file\n  -earningInterval string\n        Earning interval of TUI in seconds\n  -env string\n        environment of system binary is running on option 1- \"local\" option 2- \"ec2\"\n  -hmyPath string\n        path to harmony binary (default is current dir)\n  -hmyUrl string\n        harmony instance url\n  -logPath string\n        path to harmony log folder \"latest\"\n  -refreshInterval string\n        Refresh interval of TUI in seconds\n  -silent\n        run TUI/telegram bot in background\n  -telegramToken string\n        telegram token of your telegram bot\n  -version\n        version of the binary\n```\nExamples\n1. Run binary - `path_to_binary/harmony-tui --address=YOUR_ONE_ADDRESS --env=local`\n2. Check version - `path_to_binary/harmony-tui --version`\n\n# Configure telegram bot\n1. [Create telegram bot](https://core.telegram.org/bots#creating-a-new-bot)\n2. Pass telegram token with TUI `./harmonu-tui --telegramToken=\u003cYour_Token\u003e`\n3. Optional: Run Telegram bot in background `./harmonu-tui --telegramToken=\u003cYour_Token\u003e --silent \u0026`\n4. Search name of your telgram bot and type help to get list of supported commands\n\n# Configfile\nTUI dumps all the config into `./config-tui.json`.\nCommandline parms like telegramToken/OneAddress are needed to be passed only once.\nThere after they are recored in config file.\nThe file can be modified to change the config.\nCommandline param always have higher precendence than config file.\n\n# Sample screenshot\n![alt text](https://raw.githubusercontent.com/harmony-one/harmony-tui/master/doc/images/tui-sample.gif?token=AEY7S2JV6DIWLODPOXCKMN25VED6W)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fharmony-one%2Fharmony-tui","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fharmony-one%2Fharmony-tui","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fharmony-one%2Fharmony-tui/lists"}