# R-Scope 2.2.3 — Installation Guide

Self-hosted browser file manager. No database required.

---

## Mode A — Easiest (Windows, local PC)

**For most buyers.** No FTP, no server setup.

1. Unzip this folder anywhere (e.g. `Desktop\r-scope\`).
2. **Double-click `Start R-Scope.bat`**
3. Your browser opens at `http://127.0.0.1:8080/`

If you see "PHP not found":

- Install [XAMPP](https://www.apachefriends.org/) (free), then run the `.bat` again, **or**
- Put portable PHP at `php\php.exe` (see `php\README.txt`)

To stop: close the black console window.

See also: `QUICKSTART.txt`

---

## Mode B — Web hosting / XAMPP folder

For users who want R-Scope on a real URL.

### Requirements

- PHP 7.4+ (8.x recommended)
- Apache or nginx with PHP enabled
- Writable `config/` folder (for password setup)

### Quick start (XAMPP / Laragon)

1. Install [XAMPP](https://www.apachefriends.org/) or [Laragon](https://laragon.org/).
2. Unzip into web root, e.g. `C:\xampp\htdocs\r-scope\`
3. Open `http://localhost/r-scope/root-proxy.php`
4. Optional: set a site password via **🔑 Password** in the toolbar.

## Quick start (shared hosting)

1. Upload **all files** in this ZIP to a folder on your server, e.g.
   `public_html/tools/` or directly under `public_html/`.
2. Open:
   - `https://your-domain.com/tools/root-proxy.php`
3. Ensure `config/` is writable (chmod 755 or 775).

## Entry points (scope)

| File | What it manages |
|------|-----------------|
| `root-proxy.php` | **Entire document root** (recommended) |
| `scope-proxy.php` | Only the folder where these files live |
| `R-Scope.php` | Same folder as the app (direct access) |

**Scope** is the key idea: one app, different roots — no server reconfiguration.

## First-time setup

1. Open `root-proxy.php`.
2. Click **🔑 Password** to set a shared login (optional but recommended).
3. Select a folder → **🔒 Protect** to require login for that folder.

## User guides

| File | Language |
|------|----------|
| `R-Scope-manual-index.php` | Guide index |
| `R-Scope-manual-en.php` | English |
| `R-Scope-manual-ja.php` | Japanese |

Open via browser, e.g. `http://localhost/r-scope/R-Scope-manual-en.php`

## Troubleshooting

| Problem | Fix |
|---------|-----|
| HTTP 500 on `R-Scope.php` | Use `root-proxy.php` instead |
| Cannot save password | Make `config/` writable |
| Blank page | Check PHP error log; ensure PHP 7.4+ |

## Folder layout

```
your-folder/
├── root-proxy.php       ← start here
├── R-Scope.php
├── scope-proxy.php
├── rscope-paths.php
├── lib/
├── config/rscope.json
└── R-Scope-manual-*.php
```

## License

See `LICENSE.txt`. Official support applies to unmodified copies purchased
through the authorized seller only.

— ReNote Consortium · R-Scope v2.2.3