For the complete documentation index, see llms.txt. This page is also available as Markdown.

Set up on your Mac

goodcryptoX for Mac is an app in the menu bar that you install from one download and use in your browser. It updates itself, starts when you log in and trades while your Mac is on and online.

macOS 13.5 or later, Apple silicon or Intel.

Start goodcryptoX

  1. Download goodcryptoX and open the .dmg.

  2. Drag goodcryptoX onto Applications, then double-click goodcryptoX in the same window.

  3. goodcryptoX appears in the menu bar at the top right, and your browser opens it. Set up goodcryptoX on the Dashboard walks you through the rest: your exchange accounts, then your Telegram bot.

If macOS asks before opening it

The first time, macOS says goodcryptoX was downloaded from the internet and that Apple checked it: choose Open. You do this once. If an older goodcryptoX is installed, quit it first (its menu, Quit goodcryptoX) and choose Replace. If your Mac asks for an administrator password to copy it, use the Applications folder in your home folder instead.

The dot on goodcryptoX's mark in the menu bar says how things stand: green, all is well; yellow, something to look at; red, something needs you now. goodcryptoX starts when you log in and keeps running with the browser closed. With Keep the Mac awake on (Settings › General › Installation), it keeps a plugged-in Mac from sleeping.

Another browser

To use goodcryptoX in another browser on this Mac, type localhost:8118 in its address bar and press Unlock. If that address does not open, choose Copy sign-in link in the goodcryptoX menu and paste it there.

Add a phone or another computer

Your phone and your other computers connect from Settings › Devices › Add a device (Phone access).

Proxy

A proxy sends every exchange connection through an address you choose, on a computer, a NAS or a server.

Open Settings › General › Installation › Proxy, turn Proxy On, enter socks5://host:port or http://host:port, and press Save. With no saved address, Save turns it on. With an address saved, the switch saves at once; Off keeps the address for next time. The saved address masks its password; Edit opens it with Save and Cancel, and Remove clears it and turns Proxy off. An empty field shows no warning; an address that is not a SOCKS5 or HTTP address warns at the field after Save and is not saved. If the proxy needs a login, use socks5://user:password@host:port or http://user:password@host:port; encode special characters in the login (for example, @ as %40). Use a proxy you trust. Existing exchange streams reconnect through it without restarting goodcryptoX. If the proxy fails, goodcryptoX alerts you; check the address and login, or turn Proxy Off to connect directly.

For a terminal or Docker installation, set GCX_PROXY=socks5://host:port (or the HTTP address) in its environment before starting goodcryptoX. Once you save Proxy in Settings, that choice wins over the environment, including Off. The proxy covers exchanges; goodcryptoX's relay, reports, updates and other services connect directly.

On a server or NAS, you can run a VPN through a Gluetun sidecar: add the service below to your existing Compose file, fill in your VPN provider's details, and keep goodcryptoX's network_mode: host. Only Gluetun uses the VPN; goodcryptoX's services stay direct. Start the updated project, then save http://127.0.0.1:8888 in Proxy (or set GCX_PROXY on the gcx service). The proxy port is available only on this machine. The VPN provider must support the OpenVPN credentials you supply; a NAS must have /dev/net/tun and allow the NET_ADMIN capability.

Questions

Does goodcryptoX trade while my Mac sleeps?

No: it trades only while this Mac is on and online, though orders resting on the exchange still fill. With Keep the Mac awake on, it keeps a plugged-in Mac from sleeping.

Which Macs does goodcryptoX run on?

macOS 13.5 or later, on Apple silicon or Intel.

Can I move goodcryptoX from my Mac later?

Yes: move it to a NAS at home or a rented server in one file, accounts and bots included (Moving goodcryptoX).

Can I use goodcryptoX on my phone?

Yes: add your phone from Settings › Devices › Add a device (Phone access).

Last updated