Assuming xschem is installed in one of the ${PATH} search paths just execute:

user:~$ xschem

the xschem window should appear. If xschem is not in the search path then specify its full pathname.

if a filename is given that file will be loaded on startup:

user:~$ xschem .../xschem_library/examples/0_examples_top.sch


xschem accepts short (-h) or long (--help) options:

usage: xschem [options] [schematic | symbol ]
  -h  --help           print this help
  -n  --netlist        do a netlist of the given schematic cell
  -v  --version        print version information and exit.
  -V  --vhdl           set netlist type to VHDL
  -S  --simulate       run a simulation of the current schematc file 
                       (spice/Verilog/VHDL, depending on the netlist 
                       type chosen).
  -w  --verilog        set netlist type to Verilog
      --tcl            execute specified tcl instructions before any other action.
                       this can be used to change xschemrc variables.
  -i  --no_rcload      do not load any xschemrc file
  -o  --netlist_path   set output for netlist
  -t  --tedax          set netlist type to tEDAx
  -s  --spice          set netlist type to SPICE
  -3  --a3page         set page size for pdf export to A3
  -x  --no_x           dont use X (only command mode)
      --events         Do not use tclreadline, empty tcl shell prompt, dump
                       activity on stdout for remote controlling other software
  -z  --rainbow        use a raibow-looking layer color table
  -W  --waves          show simulation waveforms
  -f  --flat_netlist   set flat netlist (for spice format only)
  -r  --no_readline    start without the tclreadline package ( this is
                       necessary if stdin and stdout are to be redirected
                       for example to /dev/null).
  -c  --color_ps       set color postscript
  --plotfile <file>    use <file> as output for plot (png, svg, ps)
  --rcfile <file>      use <file> as a rc file for startup instead of the
                       default xschemrc.
  -p  --postscript
      --pdf            export pdf schematic
      --png            export png schematic
      --svg            export svg schematic
  -q  --quit           quit after doing things (no interactive mode)
  -l <file>
  --log <file>         set a log file
  -d <n>
  --debug <n>          set debug level:  1,  2,  3,..  C program debug
                                       -1, -2, -3...  TCL frontend debug

xschem: interactive schematic capture program

Example:   xschem counter.sch
the schematic file `counter.sch' will be loaded.



To create a new schematic run xschem and give a non existent filename:
xschem aaa.sch

You can save the schematic by pressing '<ctrl shift>s' or by using the menu File - Save As:

If no filename change is needed you can just use File - Save. Now a new empty schematic file is created. You can use this test.sch for testing while reading the manual. After exiting XSCHEM you can load directly this schematic with the following commands, they are all equivalent.

# xschem defaults its search to the 
# .sch may be omitted, it is added by default ...
xschem test
# or ...
xschem /home/schippes/x/test.sch
# or ...
xschem ${HOME}/schippes/x/test

you can load test.sch when xschem is running by using the load command '<ctrl>o' key or by menu Open command. Use the file selector dialog to locate the schematic and load it in. When loading a new file XSCHEM asks to save the currently loaded schematic if it has been modified.