📖 R-Scope User Guide (Standalone)

1. Overview

R-Scope is a browser-based file manager for your web server. It runs as a single PHP application — no Apache .htpasswd required for folder protection.

This guide covers the standalone deployment (e.g. https://lab.rnote.jp/root-proxy.php), where R-Scope manages files from your site's document root.

2. Standalone deployment (root-proxy)

On lab.rnote.jp and similar setups, open:

https://lab.rnote.jp/root-proxy.php

How it works

First-time setup

1. Open root-proxy.php (or R-Scope.php).
2. Click 🔑 Password and set the shared access password.
3. Select a folder → 🔒 Protect to require login for that folder and its contents.

3. Interface

Three panes: left folder tree · center file list · right preview.

Toolbar

Context menu (right-click)

ZIP compress/extract, rename, permissions, delete, protect/unprotect, and more.

ShotMemo (named scenes)

Save the current left tree + center folder + right preview under a name, then click Go later to restore that checkpoint. Stored in config/scopes.json (scenes array).

Text editing

Open .txt .md .php .html etc. in the built-in editor.

• 💾 Save — writes file (creates .bak backup first)
• ↩ Undo / ↪ Redo — or Ctrl+Z / Ctrl+Y

4. Copying files (drag & drop)

Drag from Windows Explorer or Outlook onto the center pane or preview area.

1. Select the destination folder in the left tree.
2. Drop files or folders onto the highlighted blue area.
3. Folder structure is preserved when dropping a whole folder.

5. Folder protection & viewing password

The standalone edition uses two separate mechanisms. The toolbar buttons look similar but do different jobs.

How the two pieces fit together

Recommended setup order

1. 🔑 Password — set the shared viewing password (required; without it, .protected does nothing)
2. Select a folder → 🔒 Protect (creates an empty .protected marker file)
3. Visitors without a session are prompted when they try to open protected paths
4. 🔓 Unprotect removes the marker when no longer needed

What protection blocks (and what it does not)

Your original files are never modified by protection — only visibility through R-Scope is restricted. Folders in the list show a leading 🔒 when protected.

6. Photos & field annotations (.rnote)

Select jpg / png / gif / webp / bmp to open the image workspace.

📍 Field annotations (recommended)

Does not change the original photo. Overlays are saved to photo.jpg.rnote (sidecar, like Lightroom XMP).

🎨 Pixel editing

Modifies the actual image file.

• Resize, brightness, contrast, saturation, sharpen, blur, grayscale, sepia
• Crop, rotate
• 💾 Save (overwrite + .bak) or 📄 Save as

7. Typical file layout (standalone)

/public_html/                    ← document root (root-proxy scope)
├── root-proxy.php               ← open R-Scope at domain root
├── R-Scope.php                  ← file manager core
├── R-Scope-manual-en.php        ← this guide
├── config/
│   ├── rscope.json              ← viewing password (hash)
│   └── scopes.json              ← ShotMemo scenes, etc.
├── lib/
├── projects/
│   └── .protected               ← protection marker (empty file OK)
└── photo.jpg
    photo.jpg.rnote              ← annotations (original unchanged)
    

8. FAQ

Q. Where are edited photos saved?

Annotation mode → only filename.rnote; image unchanged.
Pixel edit + Save → overwrites the image on the server.

Q. Forgot the viewing password?

Clear password_hash in config/rscope.json on the server, or — if you can still log in — set a new password with 🔑 Password.

Q. Does 🔒 Protect prevent deletion?

No. It hides / blocks access to content when not logged in. After login, delete and upload still work.

Q. root-proxy vs R-Scope.php?

Both load the same app. root-proxy.php sets the root to the entire document root. R-Scope.php uses its own directory as root.

Q. Recommended browser?

Chrome or Edge (folder drag-and-drop and canvas image tools).

Q. Board Room integration?

Optional portal for housing associations (NEWS + folder browser). See the Japanese Board Room guide on welv51.org.