Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/jontok/notpy
https://github.com/jontok/notpy
markdown note-taking notebook notes notetaking python
Last synced: 4 days ago
JSON representation
- Host: GitHub
- URL: https://github.com/jontok/notpy
- Owner: jontok
- License: gpl-3.0
- Created: 2023-04-14T23:59:44.000Z (over 1 year ago)
- Default Branch: master
- Last Pushed: 2023-11-19T23:01:47.000Z (about 1 year ago)
- Last Synced: 2024-11-15T10:57:01.520Z (5 days ago)
- Topics: markdown, note-taking, notebook, notes, notetaking, python
- Language: Python
- Homepage: https://pypi.org/project/notpy/
- Size: 80.1 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# NotPy
A command line tool to manage markdown files for taking notes.
[](https://github.com/jontok/Notpy/actions/workflows/build_and_test.yml)
## Introduction
NotPy is a tool to help you manage markdown files for taking notes. You can create, edit, and delete notebooks and pages with simple CLI commands. NotPy is built using Python, and it uses some third-party libraries such as `click`, `pathlib`, and `toml`.
## Getting started
To use NotPy, you need to install Python 3.6 or later. To install NotPy, clone the repository and install the requirements:
```
git clone https://github.com/NotPy/notpy.git
cd notpy
pip install -r requirements.txt
```
To start NotPy, you can run the command:
```
python notpy.py
```
You can also run NotPy from anywhere by adding the path to the `notpy.py` file to your system's `PATH` variable.
## Usage
NotPy has four main commands: `ls`, `edit`, `create`, and `delete`.
### `ls`
The `ls` command is used to list notebooks and pages. To list notebooks, use the command:
```
notpy ls nb
```
To list pages in a notebook, use the command:
```
notpy ls pg
```
Replace `` with the ID or name of the notebook you want to list the pages for.
### `edit`
The `edit` command is used to edit pages. To edit a page, use the command:
```
notpy edit pg
```
Replace `` with the ID or name of the notebook the page is in, and replace `` with the ID or name of the page you want to edit.
### `create`
The `create` command is used to create notebooks and pages. To create a notebook, use the command:
```
notpy create nb
```
Replace `` with the ID or name of the notebook you want to create.
To create a page, use the command:
```
notpy create pg
```
Replace `` with the ID or name of the notebook you want to create the page in, and replace `` with the name of the page you want to create.
### `delete`
The `delete` command is used to delete notebooks and pages. To delete a notebook, use the command:
```
notpy delete nb
```
Replace `` with the ID or name of the notebook you want to delete.
To delete a page, use the command:
```
notpy delete pg
```
Replace `` with the ID or name of the notebook the page is in, and replace `` with the ID or name of the page you want to delete.
## Configuration
NotPy reads its configuration from a JSON file located at `$HOME/.config/notpy/config.json`. You can modify this file to change the default settings for NotPy.
## Contributing
Contributions to NotPy are welcome! If you find a bug, have a feature request, or want to contribute code, please create an issue or a pull request on GitHub.
## License
NotPy is licensed under the GPLv3 License. See the LICENSE file for more information.