aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorMichael Tews <michael@tews.dev>2025-11-16 14:32:11 +0100
committerMichael Tews <michael@tews.dev>2025-11-16 14:32:11 +0100
commit639da8adad4863d52fed8e76efed2fab35f9d3a9 (patch)
treebc9bddc4008a6b9b0931516c4cbc48f46af23e55
parent26526d1e35284d4b9033cc7b48151c9cc88aeee9 (diff)
docs: adds usage info
-rw-r--r--README.md46
1 files changed, 46 insertions, 0 deletions
diff --git a/README.md b/README.md
index b8a785d..ae39763 100644
--- a/README.md
+++ b/README.md
@@ -5,3 +5,49 @@ This project provides an **rclone backend** for accessing files from **Stud.IP**
Although it should work with all Stud.IP instances, it has currently only been tested with the [University of Bremen](https://elearning.uni-bremen.de) installation.
**Note:** This is a **proof of concept** and currently offers **limited functionality (read-only access)** and **may contain bugs**.
+
+## Usage
+
+You can use this backend either as an rclone plugin or by building a custom rclone binary with the backend compiled in.
+
+### 1. Build as an rclone plugin (Supported on macOS & Linux as of now)
+
+1. Edit `/backend/studip/studip.go` and change the package declaration at the top from:
+
+```go
+package studip
+````
+
+to:
+
+```go
+package main
+```
+
+2. Build the plugin using Go’s plugin build mode:
+
+```bash
+go build --buildmode=plugin -o librcloneplugin_backend_studip.so backend/studip/studip.go
+```
+
+3. Load the plugin
+
+```bash
+mv librcloneplugin_backend_studip.so $RCLONE_PLUGIN_PATH/
+```
+- All plugins in the folder specified by variable $RCLONE_PLUGIN_PATH are loaded.
+- If this variable doesn't exist, plugin support is disabled.
+- Plugins must be compiled against the exact version of rclone to work. (The rclone used during building the plugin must be the same as the source of rclone)
+
+
+
+
+### 2. Build a custom rclone binary with the backend included
+
+You can also build a full rclone binary that has the Stud.IP backend compiled in.
+
+From the repository root, build rclone with:
+
+```bash
+go build -o rclone-studip
+```