Common Issues

HoppyShare not appearing in systray

If the setup steps aren't followed correctly, HoppyShare may get stuck in a "half-installed" state. A common problem is when HoppyShare doesn't relocate itself from the downloads directory. The fastest fix is to completely remove it and reinstall fresh.

1. Clear stored credentials

  • Windows: Open the windows search bar, type credential manager. Scroll until you find the HoppyShare entries and remove them all.
  • macOS: Open Keychain Access, search hoppyshare, find and delete the entry.
  • Linux: Delete the relevant .keyring from ~/.local/share/keyrings/. If it is locked, delete and recreate the keyring.

2. Delete application files manually

  • Windows: Remove %LOCALAPPDATA%\HoppyShare\HoppyShare.exe.
  • macOS: Delete ~/Library/Application Support/HoppyShare/HoppyShare.
  • Linux: Remove ~/.local/bin/hoppyshare.

3. Disable autostart entries

  • Windows: Delete the shortcut in the Startup folder.
  • macOS: Remove the .plist in LaunchAgents or disable via launchctl.
  • Linux: Remove the .desktop file from ~/.config/autostart/.

4. Reinstall cleanly

  • Download the latest HoppyShare binary, follow the setup steps for your OS closely, and you should be good to go.

Mobile

How do I set up HoppyShare on my Android phone?

  1. Download the HoppyShare app from the Google Play Store.
  2. Open the app. On first launch, it will automatically take you to our secure setup page.
  3. Sign in with Google when prompted.
  4. You'll be redirected back into the app, and your phone will be added automatically.

Can I start the mobile setup from the browser?

No. If you visit hoppyshare.com/add-device/mobile on your phone, a device will be added—but the mobile setup won't complete from the browser. The process only works when it's started inside the Android app.

iOS availability

Not yet—iOS is coming soon. For now, only the Android app is supported for mobile devices.

Device Limitations

Android BLE

BLE implementation on android is still a work in progress.

Android settings

Hoppyshare is not aware of the type of device that is registered. Thus, while the web gui shows all the settings for an Android device, the mobile app itself only listens for the following settings:

  1. Muted
  2. Device Nickname
  3. Send to self

Windows BLE

While the windows implementation of BLE can receive messages from other devices, it cannot send messages. It is also a bit buggy and may take a while to discover peers.

Linux Prerequisites

Clients must have the following installed:

gnome-keyring

After installing, ensure it is running:

gnome-keyring-daemon --start --components=secrets

Set required environment variables (GNOME_KEYRING_CONTROL) or alternatively try dbus-launch

Optionally, test storing:

secret-tool store --label="test" application test

Then retreiving the key:

secret-tool lookup application test
Clipboard interface

For Wayland:

wl-clipboard

For X11:

xClip