Development
January 2, 2026 ยท View on GitHub
You will need the flutter SDK to be installed on your platform. Follow the guide at https://docs.flutter.dev/get-started/install.
Linux
You might need to install cmake, openssl, ninja, curl.
git clone --recurse-submodules git@github.com:G-Ray/pikatorrent.git
cd pikatorrent/app
flutter run # start the app in development mode
flutter build linux # release
MacOS
git clone --recurse-submodules git@github.com:G-Ray/pikatorrent.git
cd pikatorrent/app
export VCPKG_ROOT="$(pwd)/vcpkg"
export VCPKG_MANIFEST_DIR=$(pwd)
# Should be same as defined in /app/macos/Runner.xcodeproj
export MACOSX_DEPLOYMENT_TARGET=10.14
./vcpkg/bootstrap-vcpkg.sh
flutter run -d macos # start the app in development mode
Windows:
git clone --recurse-submodules git@github.com:G-Ray/pikatorrent.git
cd pikatorrent/app
$Env:VCPKG_ROOT="$(pwd)/vcpkg"
$Env:VCPKG_MANIFEST_DIR="$(pwd)"
# Workaround for https://gitlab.kitware.com/cmake/cmake/-/issues/25936
$Env:TRANSMISSION_PREFIX="C:\Users\[YOUR_USER]\transmission-prefix"
.\vcpkg\bootstrap-vcpkg.bat
flutter run
Android (Linux host)
Install & configure Android SDK/NDK first.
git clone --recurse-submodules git@github.com:G-Ray/pikatorrent.git
cd pikatorrent/app
export VCPKG_ROOT="$(pwd)/vcpkg"
export VCPKG_MANIFEST_DIR=$(pwd)
./vcpkg/bootstrap-vcpkg.sh
flutter devices # List available devices
flutter run -d {device} # start the app in development mode
iOS (From a MacOS host)
git clone --recurse-submodules git@github.com:G-Ray/pikatorrent.git
cd pikatorrent/app
export VCPKG_ROOT="$(pwd)/vcpkg"
export VCPKG_MANIFEST_DIR=$(pwd)
export TARGET_IOS_DEVICE=false # false to target emulator, true to target real device
export IPHONEOS_DEPLOYMENT_TARGET=12 # Should be same as defined in /app/ios/Runner.
./vcpkg/bootstrap-vcpkg.sh
flutter devices # List available devices
flutter run -d {device_id} # start the app in development mode