gupaxx/README.md
cheese fd7c1b1ed3
Update README.md (#38)
fix: README grammar improvements and resolve some awkward sentences.
2024-11-06 23:09:31 +01:00

5.6 KiB

Gupaxx logo

Status of development

This fork has a stable release. It is intended for end users and offers a friendly and easy user experience.

Gupaxx

Gupaxx is a fork of Gupax integrating the XMRvsBeast Raffle, it is also a maintained software. Designed to simplify mining on P2Pool while optionally participating (but you will want to 😉) in the XMRvsBeast raffle.

System requirements

Gupax may not run on machines with:

  • A deprecated OS (Windows 7, Ubuntu 18.04, etc)
  • CPU whithout support for OpenGL 3.1 (<2010)

CI

Contents

What is Gupaxx/XMRvsBeast?

Gupaxx is a fork of Gupax that integrates the XMRvsBeast raffle.

With this fork, you can easily split your hashrate between P2Pool and XMRvsBeast, increasing your chances of winning in the raffle while also supporting the Monero network via decentralizing the mining using using p2pool.

For a detailed explanation of Gupax, see the README of upstream.

Guide

  1. Download the bundled version of Gupaxx
  2. Extract
  3. Launch Gupaxx

Next steps can be seen in this video tutorial.

https://github.com/Cyrix126/gupaxx/assets/58007246/610cbfea-fd97-4150-95ed-9c8a7ef5ba94

  1. Input your Monero address in the P2Pool tab
  2. Register your same address on XMRvsBeast
  3. Input the token received in the XvB Tab
  4. Start P2Pool
  5. Start XMRig
  6. Start XvB

Gupaxx will distribute your hashrate between P2Pool and XMRvsBeast as defined by this algorithm.

The algorithm will decide which quantity of HR will be directed to P2Pool and to XMRvsBeast, so that you still keep a share in the PPLNS Window. It will send by default just enough to get to the highest round or, if hero mode is enabled, everything minus the minimum required to still have a share in the PPLNS Window.

XvB Tab

CI

Console of XvB

The output of the console will show useful information on the status of the XvB process and the decision of the algorithm for every 10 minutes.

Token input

When you registered your XMR payout address, you should have received a token. Please enter this token here.

Account stats

Account stats about your address on XMRvsBeast can be found here after the process is started with your token provided.

XvB Raffle Status

Gupaxx adds a new column called XvB Raffle on the Status Tab in the Process submenu. It displays public statistics of XMRvsBeast, which are available here.
It is refreshed every minute. This column will be active if the XvB process is started even partially, it doesn't need the token to be provided.

XvB raffle stats

Other changes

This fork brings upgrades of dependence and some bugfixes about visual, performance and security that you can find in DIFFERENCES.
I will eventually (meaning when I'll have time) create pull requests for upstream about these differences.
Edit:
There is currently no plan to upstream the changes as the owner of Gupax said he won't have time to review the PR.

Troubleshooting

If you have any issue, feel free to ask for support in the xmrvsbeast matrix room Chat on Matrix or to open an issue in this repo. You can also contact me through email.

Windows

You must add an exception to your antivirus for the directory where gupaxx is executed. Follow the step for Windows Only that start at 30 seconds in this video.

Mac OSX

You must remove Gupaxx app from quarantine with following command:
If you have put Gupaxx.app in your Applications
xattr -d com.apple.quarantine /Applications/Gupaxx.app See this issue.

License

The GUI library Gupaxx uses is egui. It is licensed under MIT & Apache 2.0.

Many other libraries are used that have various licenses.

Gupaxx, P2Pool, and XMRig are licensed under the GNU General Public License v3.0.

Donations

If you'd like to thank me for the development of Gupaxx and/or motivate me to improve it you're welcome to send any amount of XMR to the following address:

8BtwGfQUJu1LahXK8fo6nNH8Bmy4pXd4UBdUEntVkk5zRfS4ax1uKR4TmAxJe3wim2HRXR22hZT6jQWgPiN7J8Nx5yGUBiX