aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorNao Pross <np@0hm.ch>2020-12-24 16:08:07 +0100
committerNao Pross <np@0hm.ch>2020-12-24 16:08:07 +0100
commit884a716f2997b494c15e3c8c2c2d292e8a2e4655 (patch)
tree2b5db5e80a669d0ce4d3c6dcd1033d1885a274e9
parentUpdate screenshot (diff)
downloadMuddle-884a716f2997b494c15e3c8c2c2d292e8a2e4655.tar.gz
Muddle-884a716f2997b494c15e3c8c2c2d292e8a2e4655.zip
Add instructions to develop on Windows in README
-rw-r--r--README.md43
1 files changed, 37 insertions, 6 deletions
diff --git a/README.md b/README.md
index b7a0f0b..c5c911a 100644
--- a/README.md
+++ b/README.md
@@ -8,16 +8,47 @@ On linux, copy `muddle.ini.sample` to `~/.config/muddle/muddle.ini` and add a to
On other platforms there is no specific path implemented yet, so it will look for a file `muddle.ini` in the same folder as the executable.
## Development
-This is written in Python 3 + PyQt. Virtualenv is probably the most comfortable way to work.
+This is written in Python 3 + PyQt. VirtualEnv is probably the most comfortable way to work.
+The code is a bit garbage, as I hacked it toghether in one morning, though I've tried to clean it up a bit.
+
+### Linux / MacOS
If you don't know how to set up a venv, type in you terminal (while in the project directory):
```bash
-muddle $ python3 -m venv venv
-muddle $ source ./venv/bin/activate
-muddle $ pip3 install -r requirements.txt
-muddle $ ./muddle --gui
+$ python3 -m venv venv
+$ source ./venv/bin/activate
+(venv) $ pip3 install -r requirements.txt
+(venv) $ ./muddle -v --gui
```
-The code is a bit garbage, as I hacked it toghether in one morning, though I've tried to clean it up a bit.
+### Windows
+
+1. Install (Python)[python.org], and in the installer enable **Add Python to the path**.
+2. Navigate to the project directory using Explorer, then Shift + Right Click and *Open Powershell Window here*
+3. In the Powershell you can now create a VirtualEnv by typing
+```powershell
+PS> python -m venv venv
+PS> .\venv\Scripts\activate
+(venv) PS> pip3 install -r requirements.txt
+(venv) PS> python muddle.py -v --gui
+```
+
+#### VirtualEnv says `running scripts is diabled on this System`
+If when activating the virtualenv using powershell you get something like this
+```
+.\venv\Scripts\activate : File C:\Users\NaoPross\Documents\Code\Muddle\venv\Scripts\Activate.ps1 cannot be loaded
+because running scripts is disabled on this system. For more information, see about_Execution_Policies at
+https:/go.microsoft.com/fwlink/?LinkID=135170.
+At line:1 char:1
++ .\venv\Scripts\activate
++ ~~~~~~~~~~~~~~~~~~~~~~~
+ + CategoryInfo : SecurityError: (:) [], PSSecurityException
+ + FullyQualifiedErrorId : UnauthorizedAccess
+```
+You need to change your ExecutionPolicy, to do that you need to type the following to allow for scripts to be executed
+```powershell
+PS> Get-ExecutionPolicy -List # see the current settings
+PS> Set-ExecutionPolicy RemoteSigned -Scope CurrentUser # allow your user to run script
+```
### Coding style