Schematic capture and circuit simulator
Permalink
Failed to load latest commit information.
.concourse fix/fedora: pkg.lst needs make Jul 27, 2018
data feat/xdg: make xdg desktop and mime install calls optout-able Aug 1, 2018
debian chore/version: bump to 0.84.39, fix debian changelog Aug 1, 2018
docs chore/doc: move diagram Sep 20, 2017
macports mac: Add Portsfile as present on MacPorts. Jan 4, 2016
mockup ui: Add mockup for new main view. Aug 25, 2015
po Major update of the Italian translation. Jul 15, 2017
src fix/slipofthepen: missing renames and making use of finalize Aug 1, 2018
test Add support for the original spice version 3 from UC Berkeley. Jun 27, 2017
tools Initial import from cvs version 0.40.4 May 27, 2005
.clang-format waf: codeformat use styleset file. Dec 26, 2014
.concourse.yml fix/ci/debian: debian recently assumes the source dir and its parent … Aug 1, 2018
.gitignore fix/git: ignore rules syntax correction Dec 16, 2017
ARCHITECTURE.md doc: minor fixes to ARCHITECTURE Feb 11, 2014
AUTHORS The following patch adds the following features and fixes: Jun 20, 2017
COPYING doc: Update GPL-2.0 license file with that from gnu.org with the prop… Dec 7, 2014
HACKING.md doc: Move some sections from README.md to HACKING.md, add flattr butt… Feb 12, 2014
README.md doc/status: add badge to show passive maintainance Mar 27, 2018
builddeps.sh ci: move to concourse.ci May 4, 2017
issue_template.md misc: Add issue_template.md for better bugreports. Feb 17, 2016
oregano.spec.in Merge pull request #219 from gtrentalancia/master Sep 23, 2017
waf feat/bump: waf version is now at 2.0.11 Sep 13, 2018
wscript chore/version: bump to 0.84.39, fix debian changelog Aug 1, 2018

README.md

oregano - an electrical engineering tool

Join the chat at https://gitter.im/drahnr/oregano Build Status Maintainance Status: Passive

About

oregano is an application for schematic capture and simulation of electronic circuits. The actual simulation is performed by Berkeley Spice, GNUcap or the new generation ngspice. oregano is licensed under the terms of the GNU GPL-2.0 included in the file COPYING.

Status

The overall status should still be considered meta-stable, some deprecations are still to be taken core of, there is plenty to do :)

Donations

Donations are very welcome!
Flattr this git repo

Support

The preferred way of supporting oregano is by sending patches and pull requests or filing bug reports.


Quick install guide

Repositories

If you are not going to build it yourself from source (which in fact is quite straightforward) you can grab a either a ready to install packages or distribution specific recipes:

Requirements

You need gtk+-3.0, glib-2.0, gio-2.0, gtksourceview-3.0, goocanvas-2.0, libxml2 and intltool in order to build oregano. These are usually included in your favorite distributions repositories and can otherwise be found at the gnome public ftp server. In order to simulate a schematic you need either ngspice or gnucap.

If you are running a recent Fedora or Ubuntu, you can simply use su -c'./builddeps.sh' to do that automatically. To install the packages yourself find the package lists under pkg-list.fedora respectivly pkg-list.ubuntu required for compilation.

Building

To build the oregano application issue the following for a debug build

./waf configure build --debug

or the following for a release build

./waf configure build --release

For additional options like specifying the install directory, consult

./waf --help

Note that additional options can be passed to the configure stage, i.e. waf configure --prefix="/usr" build -j6 is commonly used.

Attention!
If you install oregano to a different prefix than /usr, /usr/local keep in mind that the GSettings schema will be installed under ${PREFIX}/shared/glib-2.0/schemas/, which will not be checked by default. So you need to export the schema location appropriately via export XDG_DATA_DIRS=/usr/local/share:/usr/share:${HOME}/.local/share:${PREFIX}/share before launching oregano, see xdg basedir spec for further details.
Omitting the --prefix=.. option results in /usr/local as prefix, which works just fine.

Installation

For installation to the default directories, it is usually required to run

./waf install

with root privileges.

After installation oregano can be started by running oregano from terminal.

Removal

./waf uninstall

Attention!
On subsequent installs with different prefixes this will only remove the last install!


Contributions

are very welcome! We provide TODO,ARCHITECTURE.md, HACKING.md and the files under docs/* as a starting point, an overview that should help you going. If you want to discuss an issue or something you would like to implement, don't be shy, drop a message to gitter.im

Packaging

This repo also tracks packaging information for fedora (which should also be used for RedHat and CentOS, oregano.spec, use ./waf dist or git archive --format tar --prefix oregano/ HEAD | xz > $HOME/rpmbuild/SOURCE/oregano-0.83.3.tar.xz && cp oregano.spec $HOME/rpmbuild/SPECS/oregano.spec), Ubuntu (and thus Debian unstable, see the debian subdir) and soon to come for Mac (macports only contains a draft right now). If you see the need for more platforms we'd be happy to include even more.

Bugs

For bug and issue tracking as well as feature requests, the github built in issue tracker plus waffle.io

Translations

Translators are welcome to translate at transifex which will be synced into the git repository a day before a new release is created (see the release milestones for planned release dates)

Attention!
Currently translations are out of sync and will stay so until the next stable release since many error and ui strings are in the process of being unified.


FAQ

Q: Why are you doing this? A: If I don't nobody else does. Also: I really like to tinker with electronics and the workflow of geda and friends or running wine to use a glitchy windows shareware never was an option for me.