{"id":17503876,"url":"https://github.com/everoddandeven/monerod-gui","last_synced_at":"2025-10-23T17:13:43.060Z","repository":{"id":257880783,"uuid":"858907965","full_name":"everoddandeven/monerod-gui","owner":"everoddandeven","description":"A Monero node manager for Windows, MacOS and Linux","archived":false,"fork":false,"pushed_at":"2025-03-23T12:49:13.000Z","size":22442,"stargazers_count":19,"open_issues_count":2,"forks_count":2,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-17T19:18:25.234Z","etag":null,"topics":["cryptocurrency-node","monero","monero-daemon","monero-node","monerod","node-manager"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/everoddandeven.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE.md","code_of_conduct":"CODE_OF_CONDUCT.md","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":"everoddandeven","patreon":null,"open_collective":null,"ko_fi":null,"tidelift":null,"community_bridge":null,"liberapay":null,"issuehunt":null,"otechie":null,"custom":["https://github.com/everoddandeven/monerod-gui?tab=readme-ov-file#donating"]}},"created_at":"2024-09-17T18:33:22.000Z","updated_at":"2025-03-23T12:49:17.000Z","dependencies_parsed_at":"2024-12-25T13:18:33.614Z","dependency_job_id":"04ccae93-6fc9-409a-a48c-babc9bf8b39e","html_url":"https://github.com/everoddandeven/monerod-gui","commit_stats":{"total_commits":218,"total_committers":2,"mean_commits":109.0,"dds":0.03669724770642202,"last_synced_commit":"668078f99847201695efd45d4a3ae4b1ea6e9685"},"previous_names":["everoddandeven/monerod-gui"],"tags_count":12,"template":false,"template_full_name":"maximegris/angular-electron","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/everoddandeven%2Fmonerod-gui","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/everoddandeven%2Fmonerod-gui/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/everoddandeven%2Fmonerod-gui/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/everoddandeven%2Fmonerod-gui/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/everoddandeven","download_url":"https://codeload.github.com/everoddandeven/monerod-gui/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":250371788,"owners_count":21419666,"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","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":["cryptocurrency-node","monero","monero-daemon","monero-node","monerod","node-manager"],"created_at":"2024-10-19T23:14:40.167Z","updated_at":"2025-10-23T17:13:43.054Z","avatar_url":"https://github.com/everoddandeven.png","language":"TypeScript","funding_links":["https://github.com/sponsors/everoddandeven","https://github.com/everoddandeven/monerod-gui?tab=readme-ov-file#donating"],"categories":["Nodes"],"sub_categories":["Other Wallets"],"readme":"\u003cdiv align=\"center\"\u003e\n\t\u003cimg src=\"src/assets/icons/icon_128x128.png\"\u003e\n  \u003ch1\u003eMonerod GUI\u003c/h1\u003e\n  \n![Maintained][maintained-badge]\n[![Codacy Badge](https://app.codacy.com/project/badge/Grade/c705f535eebe4ba8b7a5789f6b409933)](https://app.codacy.com/gh/everoddandeven/monerod-gui/dashboard?utm_source=gh\u0026utm_medium=referral\u0026utm_content=\u0026utm_campaign=Badge_grade)\n[![Make a pull request][prs-badge]][prs]\n[![License][license-badge]](LICENSE.md)\n[![Lint Test](https://github.com/everoddandeven/monerod-gui/actions/workflows/lint.yml/badge.svg)](https://github.com/everoddandeven/monerod-gui/actions/workflows/lint.yml)\n\n[![Linux](https://github.com/everoddandeven/monerod-gui/actions/workflows/linux.yml/badge.svg)](https://github.com/everoddandeven/monerod-gui/actions/workflows/linux.yml)\n[![MacOS Build](https://github.com/everoddandeven/monerod-gui/actions/workflows/macos.yml/badge.svg)](https://github.com/everoddandeven/monerod-gui/actions/workflows/macos.yml)\n[![Windows Build](https://github.com/everoddandeven/monerod-gui/actions/workflows/windows.yml/badge.svg)](https://github.com/everoddandeven/monerod-gui/actions/workflows/windows.yml)\n\n[![Watch on GitHub][github-watch-badge]][github-watch]\n[![Star on GitHub][github-star-badge]][github-star]\n\n[![XMR Donated](https://img.shields.io/badge/donated-23.757300489601_XMR-blue?logo=monero)](https://github.com/everoddandeven/monerod-gui?tab=readme-ov-file#monero)\n\n\u003c/div\u003e\n\n## Introduction\n\n**Monerod GUI** is a desktop application that provides a graphical user interface (GUI) for installing, updating, and interacting with the Monero daemon (`monerod`). This tool simplifies the process of managing a full Monero node, enabling users to run, configure, and monitor `monerod` without needing to use the command line.\n\n## Demo\n\nhttps://github.com/user-attachments/assets/c4a50d2f-5bbb-48ac-9425-30ecc20ada7c\n\n## Features\n\n### 1. Simple Monerod Setup\n\n- Automatically downloads and installs the latest version of `monerod` based on your operating system (Windows, macOS, Linux).\n- Provides configuration options for running `monerod` with custom parameters (e.g., enabling testnet, fast block sync, blockchain pruning).\n\n### 2. Seamless Updates\n\n- Automatically checks for new `monerod` releases.\n- One-click updates to the latest version, keeping your node secure and up-to-date.\n\n### 3. Interactive Control Panel\n\n- Start, stop, and monitor the status of the Monero daemon from an intuitive control panel.\n- Configure important `monerod` settings like RPC access, logging level, concurrency, and more from the GUI.\n\n### 4. Real-Time Log Monitoring\n\n- Displays real-time `monerod` logs in a clean, readable format, helping users track sync progress, transactions, and errors.\n- Offers log filtering for easier monitoring of specific events or errors.\n\n### 5. Network and Connectivity Monitoring\n\n- Detects whether your current connection is over Wi-Fi and provides feedback on network stability.\n- Supports external bind confirmations and allows for easy configuration of RPC access control for enhanced security.\n\n### 6. Cross-Platform Support\n\n- Monerod GUI automatically detects the operating system and selects the appropriate `monerod` version to download.\n- Available for Windows, macOS, and Linux.\n\n### 7. Customizable Installation\n\n- Users can choose the installation directory for `monerod`, allowing for greater flexibility in managing the software on different systems.\n\n### 8. Anonymous Network Support\n\n- It is possible to start a `TOR` and/or `I2P` service through the node settings. This allows the user to synchronize, relay txs, and make their node available under an anonymous network in a simple and immediate way, just a few clicks.\n\n### Usage\n\n1. On the first run, Monerod GUI will detect your operating system and prompt you to download the appropriate version of `monerod`.\n2. Once installed, you can start the Monero daemon with one click and configure various settings like testnet mode, fast sync, and more.\n3. Monitor real-time logs to keep track of blockchain synchronization and transaction details.\n\n## To Do\n\n- [X] Upgrade Electron to latest version\n- [X] Upgrade Angular to latest version\n- [ ] Implement e2e tests\n- [X] Detect wired/Wi-Fi connection\n- [X] Detect battery/ac power\n- [ ] Detect preinstalled `monerod`\n  - [X] Linux\n  - [ ] Windows\n  - [ ] MacOs\n- [ ] Detect already running `monerod` instance\n- [X] Automatic startup at login\n  - [X] Linux\n  - [X] Windows\n  - [X] MacOS\n- [X] Installers\n  - [X] Linux\n  - [X] Windows\n  - [X] MacOS \n- [ ] Packages\n  - [X] Linux DEB\n  - [X] Linux RPM\n  - [X] Linux AppImage\n  - [ ] Linux Flatpack\n  - [ ] Linux Snap\n  - [X] Windows Portable EXE \n  - [X] Windows Installer MSI\n  - [X] MacOS DMG\n  - [X] MacOS PKG\n  - [X] MacOS DMG Installer\n- [X] Import/export `monerod.conf` node configuration\n- [X] Synchronization in a specific time slot\n- [ ] Prompt user access control for administration operation\n- [ ] Check for new versions of the GUI\n- [ ] Wallet RPC management\n- [ ] Blockchain tools\n  - [X] Private testnet\n  - [ ] Import blockchain\n  - [ ] Export blockchain\n  - [ ] Prune blockchain\n  - [ ] Blockchain explorer\n  - [ ] Blockchain ancestry\n  - [ ] Blockchain stats\n  - [ ] Blockchain usage\n  - [ ] Blockchain depth\n- [ ] Mining tools\n  - [ ] Calculator\n  - [ ] XMRig integration\n  - [ ] P2Pool integration\n- [ ] Network tools\n  - [ ] Generate SSL certificate\n  - [X] Tor integration\n  - [X] I2P integration\n- [ ] Remote node management\n  - [ ] No CORS connection\n  - [ ] SSH connection\n- [ ] Move to Tauri\n- [X] Port and upgrade `battery-level` dependency\n- [ ] Make this project also deployable in a web server\n- [ ] Option to download/use `cuprated` instead of `monerod`\n- [ ] Restricted RPC GUI mode\n- [ ] Light Wallet Server integration\n- [ ] Detect Whonix and use system proxy\n\n## Getting Started\n\n*Clone this repository locally:*\n\n``` bash\ngit clone https://github.com/everoddandeven/monerod-gui.git\n```\n\n*Install dependencies with npm (used by Electron renderer process):*\n\n``` bash\nnpm install\n```\n\nThere is an issue with `yarn` and `node_modules` when the application is built by the packager. Please use `npm` as dependencies manager.\n\n*Install NodeJS dependencies with npm (used by Electron main process):*\n\n``` bash\ncd app/\nnpm install\n```\n\nWhy two package.json ? This project follow [Electron Builder two package.json structure](https://www.electron.build/tutorials/two-package-structure) in order to optimize final bundle and be still able to use Angular `ng add` feature.\n\n## Project structure\n\n| Folder | Description                                      |\n|--------|--------------------------------------------------|\n| app    | Electron main process folder (NodeJS)            |\n| src    | Electron renderer process folder (Web / Angular) |\n\n## To build for development\n\n| Command                      | Description                                                                                           |\n|------------------------------|-------------------------------------------------------------------------------------------------------|\n| `npm run electron:local:dev` | Builds your application and start electron locally (DEV MODE)                                         |\n\n\nIf you want to generate Angular components with Angular-cli , you **MUST** install `@angular/cli` in npm global context.\nPlease follow [Angular-cli documentation](https://github.com/angular/angular-cli) if you had installed a previous version of `angular-cli`.\n\n``` bash\nnpm install -g @angular/cli\n```\n\n## To build for production\n\n| Command                      | Description                                                                                           |\n|------------------------------|-------------------------------------------------------------------------------------------------------|\n| `npm run electron:local`     | Builds your application and start electron locally                                                    |\n| `npm run electron:build`     | Builds your application and creates an app and installer for Windows                                  |\n| `npm run electron:build:deb` | Builds your application and creates an installer consumable for debian based operating systems        |\n| `npm run electron:build:rpm` | Builds your application and creates an installer consumable for redhat based operating systems        |\n| `npm run electron:build:mac` | Builds your application and creates an installer consumable for MacOS                                 |\n\n\n**Your application is optimised. Only /dist folder and NodeJS dependencies are included in the final bundle.**\n\n## E2E Testing\n\nE2E Test scripts can be found in `e2e` folder.\n\n| Command       | Description               |\n|---------------|---------------------------|\n| `npm run e2e` | Execute end to end tests  |\n\nNote: To make it work behind a proxy, you can add this proxy exception in your terminal  \n`export {no_proxy,NO_PROXY}=\"127.0.0.1,localhost\"`\n\n## Debug with VsCode\n\n[VsCode](https://code.visualstudio.com/) debug configuration is available! In order to use it, you need the extension [Debugger for Chrome](https://marketplace.visualstudio.com/items?itemName=msjsdiag.debugger-for-chrome).\n\nThen set some breakpoints in your application's source code.\n\nFinally from VsCode press **Ctrl+Shift+D** and select **Application Debug** and press **F5**.\n\nPlease note that Hot reload is only available in Renderer process.\n\n## Donating\n\nPlease consider donating to support the development of this project.\n\n### Monero\n\n\u003cp align=\"center\"\u003e\n \u003cimg src=\"donate.png\" width=\"115\" height=\"115\" alt=\"xmrQrCode\"/\u003e\u003cbr\u003e\n \u003ccode\u003e84Q1SdQgFWaEWRn5KcvSPCQUa3NF39EJ3HPCTaiM86RHLLftqgTZpkP24jXrK5YpeedWbQAjHcFcDLpFJfr9TypfAU7pPjA\u003c/code\u003e\n\u003c/p\u003e\n\n[maintained-badge]: https://img.shields.io/badge/maintained-yes-brightgreen\n[license-badge]: https://img.shields.io/badge/license-MIT-blue.svg\n[prs-badge]: https://img.shields.io/badge/PRs-welcome-red.svg\n[prs]: http://makeapullrequest.com\n\n[macos-build-badge]: https://github.com/everoddandeven/monerod-gui/workflows/MacOS%20Build/badge.svg\n[macos-build]: https://github.com/everoddandeven/monerod-gui/actions?query=workflow%3A%22MacOS+Build%22\n[windows-build-badge]: https://github.com/everoddandeven/monerod-gui/workflows/Windows%20Build/badge.svg\n[windows-build]: https://github.com/everoddandeven/monerod-gui/actions?query=workflow%3A%22Windows+Build%22\n\n[github-watch-badge]: https://img.shields.io/github/watchers/everoddandeven/monerod-gui.svg?style=social\n[github-watch]: https://github.com/everoddandeven/monerod-gui/watchers\n[github-star-badge]: https://img.shields.io/github/stars/everoddandeven/monerod-gui.svg?style=social\n[github-star]: https://github.com/everoddandeven/monerod-gui/stargazers\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Feveroddandeven%2Fmonerod-gui","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Feveroddandeven%2Fmonerod-gui","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Feveroddandeven%2Fmonerod-gui/lists"}