================================================================
            ClipBoard Utility
                     sanvient
================================================================

General
  This is an input support application.
  It pastes the text to other applications, inputs key code, executes windows' commands and a whole lot more.

Supported OS
  Windows 2000, XP, Vista

Install
  Uncompress to a folder. And execute 'sanvient.exe'.

Uninstall
  This application doesn't use registry.
  So delete a folder only.

File
  language      Contains language files.
  scripts       Contains script files when you execute 'script' in action.
  skin          Contains image files.
  users         Contains config files for users.
  config.ini    Default config file.
                  The application copy this file to user folder on application initialization.
  data.txt      Default config file.
                  The application copy this file to user folder on application initialization.
  sanvient.exe  Executable file.

Skin
  sanvient can change the visual style with skin.
  Click the system tray and select a skin from menu.
  Skin image files are in the skin folder.
  The folder contains a config file 'skin.ini' for skin.

How to use
  [About term]
    data        : Minimum data for the operation.
                (On windows, file)
    set         : Collection for Multiple data.
                (On windows, folder)
    item        : data and set.
    action      : After the operation of clicking button or selecting item, action is executed.
    current set : Currently selected set like windows' current directory.

  [To operate]
    sanvient has six windows.
  
    1.System tray
      Main operation.
      Right click the system tray icon, and menu will be shown.
  
    2.Button window
      Displays the buttons from 'Current Set' item.
      Push button and action will be executed.
  
    3.Treeview Window
      Displays all items with tree structure.
      You can execute action, edit item, add, remove, move, change 'Current Set'.
  
    4.Text select Window
      Displays the window with pushing the hotkey.
      Select item with keyborad or mouse, and execute.
  
    5.Menu Window
      Displays the window with pushing the hotkey.
      Or mouse cursor touches the edge of the window.
  
    6.Data Manage Window
      Displays all items with tree and list structure.
      You can edit item, add, remove, move.

  [About action]
    1.Paste
      Paste the text.

    2.File
      Write filepath and execute action, copy file and paste file.
      Write multiple files with return code, you can paste multiple files.

    3.Regular Expression
      Copy hilighted string to clipboard, and process regular expression, do paste.
      1 line is Global Option, 2 line is search pattern, 3 line is replace rule.
      And add 2 more rules under 4 line, you can do regular expression many times.

      example)
          Global Option : 2
          Search Pattern : ^.+
          Replace Rule   : // $0
          Add '//' to hilighted lines top.

    4.Key Event
      Execute key event.
      Write virtual key code, repeat count, push flag, by commas.
      Push flag:
        1: down
        2: up
        3: down and up

      example)
          65,2,3    : Down and up a virtual key code '65' ('A' key) twice.
          17,1,1,86,1,1,17,1,2,86,1,2  :  Down virtual key code '17' ('Ctrl' key) once,
                                          Down virtual key code '86' ('V' key) once,
                                          Up virtual key code '17' ('Ctrl' key) once,
                                          UP virtual key code '86' ('V' key) once.
                                          Same way to 'Ctrl + V' (Paste).

    5.Process
      Exeucte windows command.
      Write show flag, time out, command string by commas.
      Show flag:
        1: show
        0: hide (background)
      Time out is a wait time (millisecond).
      '-1' means wait until the end of application execution.

        Example:
          If you want to excute the command which copies 'C:\aaa.html' to 'C:\bbb.html'
          and  the command which copies all html files in 'C:\folder1' to 'C:\folder2' in background,
            0,0,cmd.exe /c COPY C:\aaa.html C:\bbb.html
            0,0,cmd.exe /c COPY C:\foler1\*.html C:\folder2\

    6.Script
      Executes a script file.
      Can execute combination of action, or process complex text.

    7.Multi Action
      Execute multiple actions at a time.

        Description format:
          Write an action on one line.
          In a line, action type, script name, wait time(millisecond), action content is separated by comma.
          Ignore empty lines.
          Ignore lines started with '//' and '#' as comment.
          If action content contains return code, change to '\n'.
          If action content contains '\\', change to '\\'.

        Example:
          To execute Paste and Key Event
            1,,300,test
            4,,0,65,1,3
          This description executes action type1 (pasted 'test'),
          and wait 300 milliseconds,
          and executes action type4 (input key 'A').

      The initial item 'multi action' in 'sample' executes this action.

    8.Action Link
      Executes a registered data.

        Description format:
          Write a link on one line.
          In a line, wait time(millisecond), item path is separated by comma.
          Ignore empty lines.
          Ignore lines started with '//' and '#' as comment.

        Item path:
          Item path is a string to identify items.
          (In windows, this means file path)
          A root item is '/', and items under the root are separated by '/'.
          There are absolute path and relative path.
          Absolute path starts with '/'.
          Relative path is relative position from the item.
          '../' means up path.
          Example:
            To write 'test21' in 'test 20' from 'test11' in 'test10'.
            [items]
              test10
                test11
              test20
                test21
            [Relative path]
              ../test20/test21
            [Absolute path]
              /test20/test21

        Example:
          To execute 'paste' and 'key' in 'sample'.
            300,/sample/paste
            0,key
          After exeuting '/sample/paste' wait 300 milliseconds, 
          and exeutes /sample/key.

      The initial item 'action link' in 'sample' executes this action.

    9.Shell
      Executes as a window's shell command.
      If setting URL, default web browser opens url.
      If setting a existing file, an associated application opens the file.
      If setting a existing folder, explorer opens the folder.

  [About share]
    Share the clipboard data in network.
    When copying a data to clipboard, send (receive) data to network.
    'Share', 'Receive' and 'Send'.
    Share - Write hostname or IP address and port number in 'Host List'.
          ex.
            127.0.0.1:30215
          Can multi host with return.
    Receive - Set port to accept data receiving.
              Use an unique port number to avoid conflicting other application.
    Send - 'encrypt send data' is sending encrypted data in network.
           'Name' is the name to notify to others.

Attention
  This software is freeware.
  But copyright is protected.
  Whatever happens by using this software, I can't take responsibility for it.
  So use this software for self-responsibility.

Contact
  Report bugs and requests to this address.

  Mail: sanvient@gmail.com
  URL: http://www.deepskyblue.net/software/sanvient/

