Difference between revisions of "GnuCash Sources"

From GnuCash
Jump to: navigation, search
(Refine the Sourceforge down loads notes)
(Replace obsolete material with pointers to pages that are more frequently maintained.)
 
(6 intermediate revisions by one other user not shown)
Line 1: Line 1:
 
== GnuCash Sources ==
 
== GnuCash Sources ==
===Stable Releases===
 
'''Note:''' The latest released version is '''{{Version}}'''.
 
  
The latest stable release of the GnuCash source code as zipped tar archives are available for download from:
+
GnuCash source code is available to the general public from our [https://github.com/gnucash/Gnucash git mirror repository], see [[Git]] for information on how to clone the repository or fork it on GitHub.
* [https://www.gnucash.org/index.phtml Gnucash Website] Linux source link;
 
* [https://www.gnucash.org/download.phtml Gnucash website Download] page, bzip2 compressed tarball link;
 
* [https://sourceforge.net/projects/gnucash/?source=directory SourceForge GnuCash] page.
 
These links all point to the SourceForge Download page and will download a zipped (compressed) tarball containing the sources for gnucash with a name of the form '''gnucash-<major>.<minor>-<packing>.tar.<bz2> ''', e.g. '''gnucash-{{Version}}-1.tar.bz2'''.  
 
  
All available stable releases are available from [https://sourceforge.net/projects/gnucash/?source=navbar | SourceForge] by selecting '''gnucash(stable) ''' from the Files tab then selecting the version you require. The page has downloads for Windows, Mac-OSX, and bzip2 and gz zipped sources. For Linux select the source code '''gnucash-<version>-1.tar.bz2''' or '''gnucash-<version>-1.tar.gz''' file depending upon which zip your distribution uses. You will find appropriate sha256sum values listed at the bottom of each <version> page which you can use to check the download integrity as described below.
+
We also distribute tarballs of releases at [https://sourceforge.net/projects/gnucash/files SourceForge] and [https://github.com/gnucash/Gnucash/releases Github].
  
You should save this file to a suitable location, e.g. Downloads directory in your home directory (/home/<user>/Downloads or $HOME/Downloads if the environment variable HOME is defined. Here <user> is your username on your system).
+
We have [[Building|generic instructions for building]] as well as more detailed instructions for particular platforms like [[Building_on_Windows|Microsoft Windows]], [[MacOS/Quartz|macOS]] and [[Building_On_Linux|Linux]].
 
 
You should then extract the source code from the zipped archive to a suitable directory under your home directory where you will build gnucash, e.g. something like /home/<user>/Applications. The extracted top level source file usually has the same name as the archive.
 
 
 
In a shell, enter the following commands to download and check the tarball:
 
<SyntaxHighlight lang="sh">
 
export VERSION=3.1                                                                        # One place to adjust the version;
 
export TARBALL=gnucash-$VERSION-1.tar.bz2                                                # if you still have no bzip2 use ".gz" instead of ".bz2";
 
export URL=https://sourceforge.net/projects/gnucash/files/gnucash%20%28stable%29/$VERSION # ;
 
cd ~/Downloads                                                                            # "~" short for "$HOME" = "/home/<user>";
 
wget $URL/$TARBALL                                                                        # Download the tarball;
 
sha256sum $TARBALL                                                                        # Integrity check: Compare the output with the sha256sum from the URL;
 
tar -xjvf $TARBALL -C ~/Applications                                                      # extract the tarball below your personal Applications directory;
 
</SyntaxHighlight>.
 
 
 
=== Unstable Releases ===
 
Unstable releases rae also available from the [https://sourceforge.net/projects/gnucash/?source=navbar | SourceForge] page by selecting '''gnucash(unstable)''' option from the Files tab and then selecting the release you require from that page. Substitue '''unstable''' for '''stable''' in the export defining URL to use the above commands to download unstable releases.
 
 
 
=== Developers Source Code===
 
The development source code is available from the GitHub repository using [[Git]]
 
: '''Do not attempt to use tarballs from GitHub.'''
 
Examine the [[Dependencies]] wiki page and the [https://github.com/Gnucash/gnucash/blob/master/README.dependencies README.dependencies] file for the list of build dependencies for your distribution, the [https://github.com/Gnucash/gnucash/blob/master/README.git README.git] file for notes on compiling gnucash, and the [https://github.com/Gnucash/gnucash/blob/master/HACKING HACKING] file for notes on hacking the code.
 
 
 
In a shell enter
 
<SyntaxHighlight lang="sh">
 
git clone -b maint https://github.com/Gnucash/gnucash.git   
 
</SyntaxHighlight>
 
# The to level directory downloaded by git will be named "gnucash" not "gnucash-3.<x>".
 
# Either rename it or subsitute "gnucash" where "gnucash-3.<x>" occurs in the following commands.
 

Latest revision as of 03:58, 23 December 2023

GnuCash Sources

GnuCash source code is available to the general public from our git mirror repository, see Git for information on how to clone the repository or fork it on GitHub.

We also distribute tarballs of releases at SourceForge and Github.

We have generic instructions for building as well as more detailed instructions for particular platforms like Microsoft Windows, macOS and Linux.