Home

Blog

Fatcats BBS

Popular Projects
Android stuff
DrugLord, a Dope Wars style door game
FatFish, a fishing simulation door game
Haiku OS ports and stuff
SyncHack, multiplayer rogue-like BBS shell
Synkroban, Sokoban for Synchronet

CONCH
  Conch is a rudimentary shell and virtual filesystem for Synchronet BBSes. It
  gives your users a /home/username directory, and allows users to upload and
  read each others' files.
  
  Conch currently gives read access to everyone. Users have write access within
  their homes. Conch was coded with sharing files in mind, not storing private
  information.
  
SCREENSHOTS/EXAMPLE
The following shows Conch integrated with SyncHack, a shell for Synchronet:
- User presses "$" in SyncHack to toggle the showing/hiding of the Conch
  console. Here Conch is sliding in on top of SyncHack:
  

- Conch session in progress. When the user is done they can hide the console.
  When they show Conch again, the same session is continued, with the output
  from before. The session persists until the user logs out (quits script where
  the Conch() object was instantiated).

SUPPORT
  You can find me on Fatcats BBS (fatcatsbbs.com), or on #Synchronet, 
  irc.bbs-scene.org. Any feedback, updates, etc. are all appreciated.
  
  Please bear in mind when making requests that Conch was written to act as a
  console session (like pressing ~ on many games). You still need to have
  a BBS shell that Conch plugs in to--Conch is not a shell replacement!
  
WARNING
  This has not been tested thoroughly. The code was developed on a Win32 
  platform. It may behave insecurely, or not at all on other platforms. You are
  welcome to send me your logs and we can try to troubleshoot the issue
  together.
  
  I have tested Conch on Windows 32-bit and Linux 64-bit systems.
  
  I'm not responsible for any damage that Conch does. Use it at your own risk. I
  wrote this for Fatcats BBS, however I thought that it may prove useful
  to others.
  
  
INSTALL
- Download latest source: (0.1r3).
- Put in your xtrn directory (i.e., C:\sbbs\xtrn\conch or /sbbs/xtrn/conch).
- Edit the first line in Conch.js, and point conch_path to the above path.
- Edit the second line in Conch.js, to set the correct slash in os_backslash for your OS.
That should be it. If you run into any errors, please drop me a line with the
relevant logs.
USAGE
- Invoke from your ECMAScript program:
---[ SuperShell.js ]---
load("c:/sbbs/xtrn/conch/Conch.js");
var conch = new Conch();
/* ... capture input from user, and if a key is pressed, for example, use the
 * following code to show conch:
 */ 
 
if (!conch.is_visible)
	conch.is_visible = true;
				
conch.show();
-----------------------
Don't forget to refresh your screen, etc after this. Conch will hide itself
on "exit", but the session will stay alive until SuperShell.js exits.
Contact me if you need help integrating Conch with your code.
COMMANDS
  cat
  cd
  cp
  edit
  ls
  mkdir
  mv
  pwd
  rm
  rmdir
  upload
  
  
Please use "man" to see the manpages and a full command list.
KNOWN ISSUES
- I don't think usernames with spaces or illegal directory characters work.
- Feel free to send me your findings regarding any security caveats.
  
  
AUTHOR
  art AT fatcats bbs DOT com.
  
  I wrote Conch to provide a persistent file system for SyncHack, my roguelike
  BBS shell.