Kalgoorlie Retro Docs

Documentation for the Kalgoorlie Retro BBS, its games and servers

User Tools

Site Tools


saltbush:scripting

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Next revision
Previous revision
saltbush:scripting [2026-11-09 14:40] – Saltbush Terminal 1.3.1 guides slatermsaltbush:scripting [2026-11-11 09:24] (current) – Saltbush Terminal 1.9.0 guides slaterm
Line 6: Line 6:
   * **Script → Cancel** stops the current tab's script and leaves the connection open.   * **Script → Cancel** stops the current tab's script and leaves the connection open.
   * **Script → Start/Stop Recording** records what you type and saves it as a Lua or Python script.   * **Script → Start/Stop Recording** records what you type and saves it as a Lua or Python script.
-  * **Script → Activity** shows script output and errors. Errors open it automatically.+  * **Script → Run** (F12) remembers the last script, its arguments and its folder, also after a restart. **Script → Run Last Script Again** (Ctrl+F12) runs it on the active tab; Shift+F12 cancels a running script. 
 +  * **Script → Activity** shows script output and errors. Errors open it automatically. Select text with the mouse and press Ctrl+C to copy it (also while a script is writing), or right-click for **Copy** and **Copy All**; the **Copy All** button copies everything. Click the terminal again to type there.
   * **Session Options → Logon → Logon script** runs a script whenever the session connects. A logon script sees everything received since the connection started; a script started with Script → Run starts with what arrives after it starts.   * **Session Options → Logon → Logon script** runs a script whenever the session connects. A logon script sees everything received since the connection started; a script started with Script → Run starts with what arrives after it starts.
  
Line 66: Line 67:
   * ''Disconnect()'', ''Connect(profile)'' and ''ConnectInTab(profile)'' open a new tab from a saved session id or a table/dict of options, ''Log(enabled, append, raw)''.   * ''Disconnect()'', ''Connect(profile)'' and ''ConnectInTab(profile)'' open a new tab from a saved session id or a table/dict of options, ''Log(enabled, append, raw)''.
   * ''Config.GetOption(name)'', ''Config.SetOption(name, value)'', ''Config.Save()'' (saves a saved session), ''Config.ConnectInTab()''. Option names are the setting names in the settings file (''font_size'', ''log_path'', ''hostname'' …); Lantern's names (''fontSize'', ''logPath'', ''host'', ''keyFile'' …) also work.   * ''Config.GetOption(name)'', ''Config.SetOption(name, value)'', ''Config.Save()'' (saves a saved session), ''Config.ConnectInTab()''. Option names are the setting names in the settings file (''font_size'', ''log_path'', ''hostname'' …); Lantern's names (''fontSize'', ''logPath'', ''host'', ''keyFile'' …) also work.
 +
 +==== BBS Directory ====
 +Low-level requests (Python ''_rpc(op, **values)'', Lua ''lantern.rpc(op, tab, values)''), the same as Lantern Terminal's:
 +  * ''bbsdir.open'', ''bbsdir.update'' (downloads the lists in the background), ''bbsdir.state'' (''visible'', ''busy'', ''status'', ''lists'', and ''entries'' in display order, each with its ''group'').
 +  * ''bbsdir.add'' with ''entry = {name, protocol, host, port, username, description}'' returns the new ''id''.
 +  * ''bbsdir.connect'' and ''bbsdir.save'' with ''name'' (or ''id''); for a BBS listed for SSH without a user name, ''via = "telnet"'' or ''via = "ssh"'' with ''username'' answers the question the window would ask.
 +  * ''bbsdir.remove'' and ''bbsdir.accept'' (Use new address) with ''name'' or ''id''.
  
 ===== SyncTERM-Lua scripts ===== ===== SyncTERM-Lua scripts =====
saltbush/scripting.1794235238.txt.gz · Last modified: by slaterm