1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
|
=======================
nvPY installation guide
=======================
.. contents:: Table of Contents
Overview
========
You can install nvPY in several ways. Windows users can easily install the pre-built binary package.
Mac and Linux users can install `the nvpy package published on pypi <https://pypi.org/project/nvpy/>`_.
Other options are shown in the table below:
+---------------------------+---------+-----+-------+
| Installation method ＼ OS | Windows | Mac | Linux |
+===========================+=========+=====+=======+
| Pre-built binary package | ○ | × | × |
+---------------------------+---------+-----+-------+
| Install from pypi | ○ | △ | ○ |
+---------------------------+---------+-----+-------+
| Install from source | △ | △ | △ |
+---------------------------+---------+-----+-------+
| Build binary yourself | △ | × | × |
+---------------------------+---------+-----+-------+
The meanings of the symbols described in the above table are as follows:
* ○ - It is supported and the main features are well tested by the maintainer.
* △ - It is supported for developers and expert users. Some features may be unstable.
* × - It may be possible, but not supported. Maintainer probably won't fix issues.
**Note:** On macOS, nvPY may be unstable. It crashes or hangs while typing text due to an underlying UI library issue in some environments.
There are many (mostly very easy) ways to install nvPY. This document summarises a number of them.
Windows step-by-step for beginners
==================================
This section describes how to install pre-built package. Follow the steps below:
1. Find the latest *stable* release from `the releases page <https://github.com/cpbotha/nvpy/releases>`_.
2. Download :code:`nvpy-windows.zip` file and extract it.
3. Create a setting file. Start a notepad by pressing Windows-R and typing :code:`notepad %HOMEPATH%\nvpy.cfg`.
And write the following settings into the notepad. ::
[nvpy]
sn_username = your_simplenote_email
sn_password = your_simplenote_password
4. Start :code:`nvpy.exe`.
5. Wait a little for full synchronization to complete.
6. Consider creating a shortcut to :code:`nvpy.exe` on your desktop or in your start menu.
To upgrade an existing installation of nvpy, just replace the :code:`nvpy` folder with the newer version.
Windows step-by-step for experts
================================
1. Download and install the Python 3.7 or later. Don't forget to install `the Python launcher <https://docs.python.org/3.7/using/windows.html#python-launcher-for-windows>`_.
2. Install `pipx <https://pypa.github.io/pipx/>`_ that the package manager for end-user applications. ::
py -3 -m pip install -U pipx
3. Install nvPY package by pipx. ::
py -3 -m pipx install nvpy
4. Create a setting file to :code:`%HOMEPATH%\nvpy.cfg` while referring to `nvpy-example.cfg <https://github.com/cpbotha/nvpy/blob/master/nvpy/nvpy-example.cfg>`_.
5. Start nvPY by pressing Windows-R and typing :code:`nvpy`.
To upgrade an existing installation of nvPY, do the following::
py -3 -m pipx upgrade nvpy
Ubuntu / Mint / Debian step-by-step
===================================
On Debian-flavoured systems with apt, current releases of nypy require Python 3.7 or later. If you are running Debian 10, Ubuntu 20.04, or later, which have a compatible release of Python as the default for `python3`, this generally works::
# Install dependencies and pipx (end-user application manager developed by the Python Packaging Authority).
sudo apt-get install python3 python3-tk python3-pip
python3 -m pip install pipx
# Install nvpy using pipx.
python3 -m pipx install nvpy
Older releases may require manual installation of python 3.7 or later.
Create a file in your home directory called :code:`.nvpy.cfg` with just the following contents::
[nvpy]
sn_username = your_simplenote_email
sn_password = your_simplenote_password
To start nvpy, just do::
nvpy
# If you get a "command not found" error, try to ~/.local/bin/nvpy
To upgrade an existing installation of nvpy, do the following::
python3 -m pipx upgrade nvpy
Integrating with your Linux desktop environment
-----------------------------------------------
nvPY ships with a `.desktop file <https://github.com/cpbotha/nvpy/blob/master/nvpy/vxlabs-nvpy.desktop>`_, so that you can easily integrate it with your Linux desktop environment. This has been tested on Ubuntu Unity, but should work on KDE, Gnome3 and other environments as well.
First edit the file to check and optionally customize the Exec and Icon entries, then install it with::
xdg-desktop-menu install vxlabs-nvpy.desktop
Alternative method
==================
Some operating systems will present you with the dependency problems when you install programs using pip without creating a virtual environment.
One solution is to use `virtualenvwrapper <https://virtualenvwrapper.readthedocs.io/en/latest/index.html>`_.
Another way to install it could be with `Conda or Miniconda <https://conda.io/en/latest/miniconda.html>`_, some distibutions provide conda in their repositories.
This example shows you how to install Conda on Fedora, standard Bash setup - change it if you use other shell. If your distribution provides the conda package, use your package manager (zypper, pacman etc), otherwise follow the official Conda documentation::
sudo dnf install conda
conda init bash
conda install pip
conda create -n nvpy
conda activate nvpy
pip install nvpy
The resulting installation will end up in :code:`~/.conda/envs/nvpy/bin`. Now symlink it or create an alias for easier access to nvpy binary.
For example NixOS distribution also provides `Conda < https://nixos.org/nixos/packages.html?query=conda>`_, to install::
nix-env -iA nixos.conda
Then follow the setup above.
Contributors and expert users
=============================
You can install nvPY from a git repository. ::
git clone git://github.com/cpbotha/nvpy.git
cd nvpy
pip3 install -U -e '.[dev]'
Don't forget to create :code:`~/.nvpy.cfg` while referring to `nvpy-example.cfg <https://github.com/cpbotha/nvpy/blob/master/nvpy/nvpy-example.cfg>`_.
To start nvpy, just do::
nvpy
To browse nvPY internal docs, just do::
pip3 install -U pdoc3
pdoc --http localhost:8080 nvpy
# Open http://localhost:8080, you can see docs.
|
