Compare commits

...
4 Commits
Author SHA1 Message Date
dumbgoy 4a360325e6 Clarify Windows executable build instructions 2026-10-27 10:11:24 -04:00
dumbgoy e20cb7b565 Merge modified Soulseek project into main 2026-10-27 10:08:25 -04:00
dumbgoy 0272512234 Document Gitea setup for Linux and Windows 2026-10-27 10:03:54 -04:00
dumbgoy 67a4b69c4a Initial commit 2026-10-27 13:58:55 +00:00
2 changed files with 74 additions and 1 deletions
+1
View File
@@ -1,6 +1,7 @@
MIT License MIT License
Copyright (c) 2026 Michel de Graaf Copyright (c) 2026 Michel de Graaf
Copyright (c) 2026 dumbgoy
Permission is hereby granted, free of charge, to any person obtaining a copy Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal of this software and associated documentation files (the "Software"), to deal
+73 -1
View File
@@ -20,7 +20,8 @@ enthusiasts to share niche music. This repository is that client plus
***Quick install:*** ***Quick install:***
`curl -fsSL https://re-invention.nl/soulseek-rs/install.sh | sh` For this Gitea version, follow [Build and run from Gitea](#build-and-run-from-gitea)
below. It includes the **Shift+D** shortcut to download a track's containing folder.
@@ -87,6 +88,77 @@ project is identifiable on the network.
## Installation ## Installation
### Build and run from Gitea
You need access to this private Gitea repository and an internet connection to
download the build dependencies.
These instructions build the application from source. No prebuilt Windows
`.exe` has been provided for this modified version; cloning the repository
does not download an executable.
**Requirements**
- **Linux:** Install Git and a C compiler/linker (`build-essential` on
Ubuntu/Debian), then install **Rust 1.91 or newer** using
[rustup](https://rust-lang.org/tools/install/).
- **Windows:** Install [Git for Windows](https://git-scm.com/download/win)
and [Rust](https://rust-lang.org/tools/install/). Accept the prompt to
install Visual Studio C++ Build Tools, using the **Desktop development
with C++** workload. Reopen PowerShell after installation.
**Download and build**
Run these commands in a Linux terminal or Windows PowerShell. Authenticate
with Gitea when prompted. The first build may take several minutes.
```sh
git clone --branch main https://git.bloggin.space/dumbgoy/soulseek-rs-modded.git
cd soulseek-rs-modded
cargo build --release -p soulseek-rs
```
**Run on Linux**
```sh
./target/release/soulseek-rs
```
**Run on Windows (PowerShell)**
Run `cargo build --release -p soulseek-rs` **on Windows** first. After a
successful build, Cargo creates `target\release\soulseek-rs.exe`. Launch that
generated executable from the project directory:
```powershell
.\target\release\soulseek-rs.exe
```
A normal Linux build produces `target/release/soulseek-rs`, a Linux binary;
it does not produce the Windows `.exe`.
Log in with your Soulseek account. Press **s** to search, enter your query,
and press **Enter**. Focus the results pane with **2**, highlight a track,
then press **Shift+D** to download all files directly in its remote folder,
including files absent from the search results. **Space** selects individual
files and **Enter** downloads that selection. Press **?** for shortcuts or
**q** to quit.
**Update later**
Close the application, run these commands inside `soulseek-rs-modded`, then
launch it again with the command for your operating system:
```sh
git pull --ff-only
cargo build --release -p soulseek-rs
```
### Upstream installation options
The installers and packages below install the original upstream project.
Use the Gitea build instructions above for this repository's modifications.
The installer picks the right macOS or Linux binary, verifies its sha256, and The installer picks the right macOS or Linux binary, verifies its sha256, and
installs the latest stable release (through Homebrew when it is available): installs the latest stable release (through Homebrew when it is available):