twister

Desktop bundles for twister-core, twister-html (web-ui), and future GTK client.

Flatpak

Important

In development!

Checkout Releases to get compiled beta

Manifest

• Freedesktop 23.08
• Berkley DB 4.8.30
  • modified libdb.patch file that resolves namespace conflict
• Boost 1.77.0
• twister-core git, twisterarmy branch
• twister-html git, twisterarmy branch

Roadmap

Even though the application is working, the following issues have not yet been resolved:

• At this moment, mining is crashing
• Resolve DHT network down status
• Flathub hosting requires:
  • upgrade to Freedesktop 24.08 (where the build fails for libdb)
  • GUI client (or wrapper) implementation for desktop-application component type
  • replace simple make with autotools
  • improve post-installation cleanup rules

Runtime

• Sandbox twisterd is listening for RPC connections on the non-standard port 28331
• Built for desktop usage, which means:
  • the launcher wraps twisterd and does not accept native commands via the CLI
  • the backend is running on a random port (as the default twister-core behavior)
  • if you want to change the startup options (e.g., for the seeding), see build-commands for html
• Upon app launch from menu, the XDG Desktop Portal should open Web-UI client in the default browser
  • or, navigate manually: http://user:pwd@localhost:28331
    • credentials are required by the native RPC implementation, and will be skipped by the redirection
  • to safely shut down the app, use Exit button (on the Network page)
• Profile data is stored at ~/.var/app/io.github.twisterarmy.Twister/.twister
• See manifest file for build details
• See Flathub RC for metainfo (read-only)

Source

git clone https://github.com/twisterarmy/twister.git && cd twister

Build

flatpak-builder --force-clean build-dir\
                --install-deps-from=flathub\
                --install\
                --repo=repo\
                --user\
                io.github.twisterarmy.Twister.json

Launch

flatpak run io.github.twisterarmy.Twister

Share

• flatpak build-bundle repo twister.flatpak io.github.twisterarmy.Twister
• flatpak install --user twister.flatpak

Contribute

• git pull
• git checkout -b patch-name - create separated branch for new PR
• flatpak run --command=flatpak-builder-lint org.flatpak.Builder manifest io.github.twisterarmy.Twister.json
• git commit -m commit-name
• git push --set-upstream origin patch-name