Skip to content

CasaVinteUm/pairdrop-startos

Repository files navigation

Project Logo

PairDrop for StartOS

PairDrop: Local file sharing in your browser. Inspired by Apple's AirDrop. Fork of Snapdrop. This repository creates the s9pk package that is installed to run pairdrop on StartOS.

Dependencies

Install the system dependencies below to build this project by following the instructions in the provided links. You can find instructions on how to set up the appropriate build environment in the Developer Docs.

Build environment

Prepare your StartOS build environment. In this example we are using Ubuntu 20.04.

  1. Install docker

    curl -fsSL https://get.docker.com | bash
    sudo usermod -aG docker "$USER"
    exec sudo su -l $USER
  2. Set buildx as the default builder

    docker buildx install
    docker buildx create --use
  3. Enable cross-arch emulated builds in docker

    docker run --privileged --rm linuxkit/binfmt:v0.8
  4. Install yq

    sudo snap install yq
  5. Install deno

    sudo snap install deno
  6. Install essentials build packages

    sudo apt-get install -y build-essential openssl libssl-dev libc6-dev clang libclang-dev ca-certificates
  7. Install Rust

    curl https://sh.rustup.rs -sSf | sh
    # Choose nr 1 (default install)
    source $HOME/.cargo/env
  8. Build and install start-sdk

    cd ~/ && git clone --recursive https://github.com/Start9Labs/start-os.git --branch sdk
    cd start-os/
    make sdk
    start-sdk init

Now you are ready to build the pairdrop package!

Cloning

Clone the project locally:

git clone https://github.com/CasaVinteUM/pairdrop-startos.git
cd pairdrop-startos
git submodule update --init --recursive

Building

To build the pairdrop package for all platforms using start-sdk, run the following command:

make

To build the pairdrop package for a single platform using start-sdk, run:

# for amd64
make x86

or

# for arm64
make arm

Installing (on StartOS)

Run the following commands to determine successful install:

ℹ️ Change server-name.local to your Start9 server address

start-cli auth login
# Enter your StartOS password
start-cli --host https://server-name.local package install pairdrop.s9pk

If you already have your start-cli config file setup with a default host, you can install simply by running:

make install

Tip: You can also install the pairdrop.s9pk using Sideload Service under the System > Manage section.

Verify Install

Go to your StartOS Services page, select Pairdrop, configure and start the service. Then, verify its interfaces are accessible.

Done!