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
---
2022-03-08 23:51:46 -08:00
2022-01-11 12:51:33 -08:00
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
2022-03-08 23:51:46 -08:00
groupId="operating-system"
defaultValue="windows"
values={[
{label: 'Ubuntu', value: 'ubuntu'},
{label: 'macOS', value: 'macos'},
{label: 'Windows', value: 'windows'},
]}>
2022-01-11 12:51:33 -08:00
<TabItem value="ubuntu">
2022-03-08 23:51:46 -08:00
- Download meshtastic_ubuntu
2022-03-08 23:51:46 -08:00
- Run the following command to make the file executable and rename it 'meshtastic':
```
chmod +x meshtastic_ubuntu && mv meshtastic_ubuntu meshtastic
```
2022-01-11 12:51:33 -08:00
2022-03-08 23:51:46 -08:00
- To run the cli:
2022-01-11 12:51:33 -08:00
```
./meshtastic
```
:::tip
Copy (or move) this binary somewhere in your path.
:::
2022-01-11 12:51:33 -08:00
</TabItem>
<TabItem value="macos">
2022-03-08 23:51:46 -08:00
- Download meshtastic_mac
2022-01-11 12:51:33 -08:00
2022-03-08 23:51:46 -08:00
- Run the following command to make the file executable and to rename it 'meshtastic':
2022-01-11 12:51:33 -08:00
```
chmod +x meshtastic_mac && mv meshtastic_mac meshtastic
```
2022-03-08 23:51:46 -08:00
- Try to run it:
```
./meshtastic
```
:::note
2022-03-08 23:51:46 -08:00
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
2022-03-08 23:51:46 -08:00
- To fix, go into "System Preferences", "Security & Privacy", "General" tab, and click on the "Allow Anyway" button.
2022-01-11 12:51:33 -08:00
2022-03-08 23:51:46 -08:00
- Try to run it again:
```
./meshtastic
```
:::note
You may get a dialog that says:
2022-03-08 23:51:46 -08:00
"meshtastic" can't be opened because Apple cannot check it for malicious software.
Click "Open".
:::
2022-03-08 23:51:46 -08:00
- Now when you want to run it, you can simply run:
2022-01-11 12:51:33 -08:00
```
./meshtastic
```
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-03-08 23:51:46 -08:00
- Download meshtastic_windows
2022-01-11 12:51:33 -08:00
2022-03-08 23:51:46 -08:00
- Rename to meshtastic.exe
2022-01-11 12:51:33 -08:00
2022-03-08 23:51:46 -08:00
- To run, open a windows command prompt, navigate to the location of the executable and run:
```
meshtastic.exe
```
2022-01-11 12:51:33 -08:00
</TabItem>
</Tabs>