gupaxx/README.md
2024-05-18 08:44:03 +02:00

5.2 KiB

Gupax logo

Status of development

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

Gupaxx

Gupaxx is a fork of Gupax integrating the XMRvsBeast Raffle, it is also a maintained software. It is made to make in the most easy way possible 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 integrate the XMRvsBeast raffle.

This fork adds an easy way to distribute your hashrate between P2pool and XMRvsBeast to participate in the raffle to win more xmr while supporting the p2pool network.

To have a detailed explication 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 here by the 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 minimum required to still have a share in the PPLNS Window.

XvB Tab

CI

Console of XvB

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

Token input

You need to put the token received when you registered your XMR payout address.

Private stats

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

XvB Raffle Status

Gupaxx add a new column 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.

Troubleshooting

If you have any issue, feel free to ask for support in the xmrvsbeast matrix room 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