2021-11-14 10:51:34 +00:00
|
|
|
<div align="center" markdown="1">
|
2021-11-14 10:54:07 +00:00
|
|
|
|
2021-11-23 07:26:46 +00:00
|
|
|
<img src=".github/logo.png" alt="Frappe Books logo" width="384"/>
|
2021-11-14 10:51:34 +00:00
|
|
|
|
2021-11-14 12:15:12 +00:00
|
|
|
---
|
2020-01-02 17:36:00 +00:00
|
|
|
|
2020-01-02 18:22:26 +00:00
|
|
|
[](https://github.com/frappe/books/releases)
|
|
|
|
|
|
|
|
|
|
|
2021-11-14 10:51:34 +00:00
|
|
|
|
2020-01-02 17:36:00 +00:00
|
|
|
Free Desktop book-keeping software for small-businesses and freelancers.
|
|
|
|
|
|
2021-12-08 13:46:43 +00:00
|
|
|
<img src=".github/frappe-books-preview.png" alt="Frappe Books Preview" />
|
2020-01-02 17:36:00 +00:00
|
|
|
|
2021-12-08 13:48:20 +00:00
|
|
|
</div>
|
2021-11-14 10:54:07 +00:00
|
|
|
|
|
|
|
|
|
2020-01-02 18:22:26 +00:00
|
|
|
## Features
|
|
|
|
|
|
|
|
|
|
1. Double-entry accounting
|
|
|
|
|
1. Invoicing
|
|
|
|
|
1. Billing
|
|
|
|
|
1. Payments
|
|
|
|
|
1. Journal Entries
|
|
|
|
|
1. Dashboard
|
|
|
|
|
1. Works Offline
|
|
|
|
|
1. Financial Reports
|
|
|
|
|
- General Ledger
|
|
|
|
|
- Profit and Loss Statement
|
|
|
|
|
- Balance Sheet
|
|
|
|
|
- Trial Balance
|
|
|
|
|
1. Multi-currency Invoicing
|
|
|
|
|
|
|
|
|
|
## Download
|
2020-01-02 17:36:00 +00:00
|
|
|
|
|
|
|
|
Download the latest release for your platform from the [releases
|
|
|
|
|
page](https://github.com/frappe/books/releases).
|
|
|
|
|
|
2020-01-02 18:22:26 +00:00
|
|
|
## Development
|
2020-01-02 17:36:00 +00:00
|
|
|
|
2022-01-21 10:53:28 +00:00
|
|
|
Frappe Books is built on Vue.js and Electron. It is offline by default, and uses
|
|
|
|
|
a local SQLite file as the database.
|
2020-01-02 17:36:00 +00:00
|
|
|
|
|
|
|
|
### Pre-requisites
|
2019-02-16 07:05:50 +00:00
|
|
|
|
2020-01-02 18:22:26 +00:00
|
|
|
1. Install build essentials
|
2019-02-16 07:05:50 +00:00
|
|
|
|
2020-01-02 18:22:26 +00:00
|
|
|
Ubuntu
|
2019-02-16 07:05:50 +00:00
|
|
|
|
2020-01-02 18:22:26 +00:00
|
|
|
```bash
|
|
|
|
|
apt-get install build-essential python git
|
|
|
|
|
apt-get install libgconf-2-4
|
|
|
|
|
```
|
2019-02-16 07:05:50 +00:00
|
|
|
|
2020-01-02 18:22:26 +00:00
|
|
|
MacOS
|
2019-02-16 07:05:50 +00:00
|
|
|
|
2020-01-02 18:22:26 +00:00
|
|
|
```bash
|
|
|
|
|
xcode-select --install
|
|
|
|
|
```
|
2019-02-16 07:05:50 +00:00
|
|
|
|
2020-01-02 18:22:26 +00:00
|
|
|
You will also need [Xcode App](https://apps.apple.com/in/app/xcode/id497799835?mt=12) from App Store
|
2018-01-09 13:40:33 +00:00
|
|
|
|
2021-11-23 07:26:46 +00:00
|
|
|
2. Install [Node.js](https://nodejs.org/en/). Check the `package.json` file for the node version.
|
2020-01-02 18:22:26 +00:00
|
|
|
> Tip: The best way to install and manage Node is to install [nvm](https://github.com/nvm-sh/nvm#usage)
|
|
|
|
|
3. Install `yarn` package manager
|
|
|
|
|
```bash
|
|
|
|
|
npm install -g yarn
|
|
|
|
|
```
|
2019-02-16 07:05:50 +00:00
|
|
|
|
2020-01-02 18:22:26 +00:00
|
|
|
### Clone and Run
|
2019-02-16 07:05:50 +00:00
|
|
|
|
2022-01-19 05:29:04 +00:00
|
|
|
Due to some `yarn.lock` issue this won't run, to run it check [Issue #315](https://github.com/frappe/books/issues/315)
|
|
|
|
|
|
2019-02-16 07:05:50 +00:00
|
|
|
```bash
|
2020-01-02 18:22:26 +00:00
|
|
|
# clone the repository
|
2020-01-02 17:36:00 +00:00
|
|
|
git clone https://github.com/frappe/books.git
|
2020-05-10 08:41:53 +00:00
|
|
|
|
2020-01-02 18:22:26 +00:00
|
|
|
# change directory
|
2020-01-02 17:36:00 +00:00
|
|
|
cd books
|
2020-05-10 08:41:53 +00:00
|
|
|
|
2020-01-02 18:22:26 +00:00
|
|
|
# install dependencies
|
2019-02-16 07:05:50 +00:00
|
|
|
yarn
|
2020-05-10 08:41:53 +00:00
|
|
|
|
2020-01-02 18:22:26 +00:00
|
|
|
# start the electron app
|
2020-01-02 17:36:00 +00:00
|
|
|
yarn electron:serve
|
2019-07-23 07:47:20 +00:00
|
|
|
```
|
2020-01-02 18:28:53 +00:00
|
|
|
|
2020-05-10 08:41:53 +00:00
|
|
|
|
2021-08-18 15:38:01 +00:00
|
|
|
### FAQ
|
|
|
|
|
|
|
|
|
|
1. Launching electron and nothing displays
|
|
|
|
|
https://github.com/nklayman/vue-cli-plugin-electron-builder/issues/24#issuecomment-770165389
|
2021-11-23 07:26:46 +00:00
|
|
|
```bash
|
2021-08-18 15:38:01 +00:00
|
|
|
sudo chown root node_modules/electron/dist/chrome-sandbox && sudo chmod 4755 node_modules/electron/dist/chrome-sandbox
|
|
|
|
|
```
|
|
|
|
|
|
2020-01-02 18:28:53 +00:00
|
|
|
## License
|
|
|
|
|
|
|
|
|
|
[GNU Affero General Public License v3.0](LICENSE)
|
