meshtastic/docs/software/python/standalone.md

103 lines
2 KiB
Markdown
Raw Normal View History

2022-01-11 12:51:33 -08:00
---
id: python-standalone
title: Meshtastic-python standalone executable
sidebar_label: Standalone
---
import Tabs from '@theme/Tabs';
import TabItem from '@theme/TabItem';
There are standalone executable files for Mac, Windows and Ubuntu. A single file is all you need to run the command line interface (CLI) Meshtastic tool. There is a zip file per operating system. To use, see the operating system specific notes below:
They can be found on the [Releases](https://github.com/meshtastic/Meshtastic-python/releases) page.
2022-01-11 12:51:33 -08:00
<Tabs
groupId="operating-system"
defaultValue="windows"
values={[
2022-02-25 23:17:16 -08:00
{label: 'Ubuntu', value: 'ubuntu'},
2022-01-11 12:51:33 -08:00
{label: 'macOS', value: 'macos'},
{label: 'Windows', value: 'windows'},
]}>
<TabItem value="ubuntu">
2022-02-25 21:37:23 -08:00
* Download meshtastic_ubuntu
* Run the following command to make the file executable:
```
2022-02-25 21:37:23 -08:00
chmod +x meshtastic_ubuntu
```
2022-01-11 12:51:33 -08:00
* To run the cli:
2022-01-11 12:51:33 -08:00
```
2022-02-25 21:37:23 -08:00
./meshtastic_ubuntu
```
:::tip
Copy (or move) this binary somewhere in your path.
:::
2022-01-11 12:51:33 -08:00
</TabItem>
<TabItem value="macos">
2022-02-25 21:37:23 -08:00
* Download meshtastic_mac
2022-01-11 12:51:33 -08:00
* Run the following command to make the file executable:
2022-01-11 12:51:33 -08:00
```
2022-02-25 21:37:23 -08:00
chmod +x meshtastic_mac
```
* Try to run it:
```
2022-02-25 21:37:23 -08:00
./meshtastic_mac
```
:::note
You may get a dialog that says:
"meshtastic" can't be opened because Apple cannot check it for malicious software.
:::
2022-01-11 12:51:33 -08:00
* To fix, go into "System Preferences", "Security & Privacy", "General" tab, and click on the "Allow Anyway" button.
* Try to run it again:
```
2022-02-25 21:37:23 -08:00
./meshtastic_mac
```
:::note
You may get a dialog that says:
2022-01-11 12:51:33 -08:00
"meshtastic" can't be opened because Apple cannot check it for malicious software.
Click "Open".
:::
* Now when you want to run it, you can simply run:
2022-01-11 12:51:33 -08:00
```
2022-02-25 21:37:23 -08:00
./meshtastic_mac
```
2022-01-11 12:51:33 -08:00
:::tip
Copy (or move) this binary somewhere in your path.
:::
2022-01-11 12:51:33 -08:00
</TabItem>
<TabItem value="windows">
2022-02-25 21:37:23 -08:00
* Download meshtastic_windows
2022-01-11 12:51:33 -08:00
2022-02-25 21:37:23 -08:00
* Rename to meshtastic_windows.exe
2022-01-11 12:51:33 -08:00
* To run, open a windows command prompt, navigate to the location of the executable and run:
```
meshtastic_windows.exe
```
2022-01-11 12:51:33 -08:00
</TabItem>
</Tabs>