GithubHelp home page GithubHelp logo

robertdigital / oregano Goto Github PK

View Code? Open in Web Editor NEW

This project forked from drahnr/oregano

0.0 1.0 0.0 6.28 MB

Schematic capture and circuit simulator

Home Page: https://ahoi.io

License: GNU General Public License v2.0

Shell 0.14% Python 1.62% HTML 1.89% C 94.59% Perl 0.07% Awk 1.39% Tcl 0.21% Dockerfile 0.02% Roff 0.06%

oregano's Introduction

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.

oregano's People

Contributors

drahnr avatar gtrentalancia avatar marc-lorber avatar mbanucu avatar gazer avatar hriesz avatar markvels avatar maxyz avatar dionysos-sf avatar lukasgibeh avatar gitter-badger avatar

Watchers

 avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.