SecureView - SFTP Viewer (0.06 alpha 12-May-2026)

The latest version is available from https://www.riscosports.co.uk/eabi

The !SecureView application is just a simple front end onto the libssh2 library
v1.11.1

Other libraries Used
--------------------

openssl 3.6.3 (https://openssl-library.org)
zlib1g 1.3.2 (https://zlib.net)
tomlc17 (https://github.com/cktan/tomlc17)

See https://www.libssh2.org for details of the libssh2 library.

Getting Started
---------------

After double clicking the !SecureView application the !SecureView icon appears
on the iconbar.

Clicking 'Select' on the SecureView iconbar icon displays the connect window. Fill in the details for the
folder you want to open then click on 'Connect'.
On successfully opening a folder you should see a filer like window appear. To navigate
double-click on a directory to open it. To get back to a previous directory double-click
'^' (You may need to scroll down if there are a lot of files in a folder.) or click menu and select 'Open parent'.
Only single files are uploadable and downloadable at the moment. Click menu over a file and save in the
normal way by dragging the icon to a local folder.
To upload a file drag it in the normal way from a Filer window.
If the file is large an hourglass will appear while it downloads/uploads. The maximum download/upload size is
limited to just under 4GB or less depending on the local file system.

Create Public/Private key Pair
------------------------------

For servers that don't support ed25519

ssh-keygen -f id_rsa

Using puttytools (recommended method)

puttygen -t ed25519 -O private-openssh-new -o ed26619
puttygen ed25519 -O public-openssh -o ed25519.pub

Example config.toml
------------------

[default]
# Ip address or hostname of the ssh server
hostname = "example.com"
# Port number of the ssh server
port = 22
# initial folder path to open
pathname = "/home/username"
# A valid username on the ssh server
user = "username"
# Set to true to enable or false to disable public key authentication
publickey = false
# Download/Upload buffer in bytes
buffersize = 16384

[ssh]
# Public/Private key pair
pubkey = "/<Choices$Dir>/secureview/id_rsa.pub"
privkey = "/<Choices$Dir>/secureview/id_rsa"

History
-------

RISC OS Version 0.01 alpha (30-Oct-22)
- this is the initial alpha release of SecureView.
RISC OS Version 0.02 alpha (05-Nov-22)
- handle path name of / correctly
- add 'Refresh' option to menu
- add 'Open parent' option to menu
- add 'Display' menu option, sort folder by either date or file name
RISC OS Version 0.03 alpha (31-Mar-26)
- can now delete an empty folder
- file time stamps maintained uploading a file
RISC OS Version 0.04 alpha (14-Apr-26)
- add 'Rename' option to menu
- populate default connection settings from config.toml
- Fix corruption when getting the file type name
- add public key authentication
RISC OS Version 0.05 alpha (10-May-26)
- fade relevant menu options depending on where menu was clicked
- can now load password protected private key
- an invalid path displays an error instead of a blank window
- file type is now maintained when uploading a file
RISC OS Version 0.06 alpha (12-May-26)
- domain name as well as ip address is supported for the 'hostname' field in the 'Connect' window
- An error is shown if unable to connect after 10 seconds instead of appearing to hang
RISC OS Version 0.07 alpha (07-Sep-26)
- Built with latest versions of libraries. openssl 3.6.3 and zlib1g 1.3.2
- Built as armv4 version. Runs on RPCEmu and all hardware after the RiscPC.

Todo
----

Add 'fingerprint' check against known_hosts and UI to prompt if unknown and add new to known_hosts file
Enable recursive delete for folders
Add file/folder delete prompt
Time-based One-Time Password (TOTP) 2FA
Add UI for creating the config.toml file
Support RAM transfers

Issues
------
It is the 7th alpha version so there will be bugs and many missing features.

This is the only documentation for the moment. Full documentation will gradually
appear as more features are added/completed.

Only single file downloads and uploads are currently enabled.

Downloads and uploads are single tasking. An hourglass will appear during the download/upload.

The number of files displayed is limited to 999,

If an error happens you may see a blank screen or the screen fails to update. Just close the window and open the folder again.

Files starting with a '/' may not download. Just change the name without a '/'.

Only single files and empty folders can be deleted. Deleting a folder containing files or folders has no effect.

Files are only sorted in case insensitve or date ascending order.

The config.toml must be created and placed in the Boot:Choices.secureview folder manually. Create the folder secureview first if
it doesn't exist.

When dragging the save box to an application or double-clicking a file nothing happens due to ram transfers not being implemented.

Contact
-------

Chris Gransden - chrisg@riscosports.co.uk

