Piper - A Python Telegram bot
=============================

# Requirements
Python 3.4

[pyTelegramBotAPI](https://github.com/eternnoir/pyTelegramBotAPI) (requirements.txt)

# Install
First, acquire a bot token from https://telegram.me/BotFather

```sh
git clone https://github.com/TheReverend403/Piper
cd Piper
virtualenv .venv -p python3
source .venv/bin/activate
pip install -r requirements.txt
cp config.ini.sample config.ini
nano config.ini # Add your bot token
python -m piper.main
```

# Upgrade
```sh
cd Piper
git pull
source .venv/bin/activate
pip install -r requirements.txt
cat config.ini.sample # Check for any new values, add them to config.ini
```

# systemd service
To run Piper as a systemd user service:

```sh
cp piper.service ~/.config/systemd/user
nano ~/.config/systemd/user/piper.service # Edit as needed
systemctl --user daemon-reload
systemctl --user enable piper
systemctl --user start piper
sudo loginctl enable-linger $USER # To allow user services to run on startup and stay after logout.
```

To run Piper as a systemd system service (not recommended):

```sh
sudo cp piper.service /etc/systemd/system
sudo nano /etc/systemd/system/piper.service # Edit as needed
sudo systemctl daemon-reload
sudo systemctl enable piper
sudo systemctl start piper
```
Piper - A Python Telegram bot
=============================

# Requirements
Python 3.4  
[pyTelegramBotAPI](https://github.com/eternnoir/pyTelegramBotAPI) (requirements.txt)

# Install
First, acquire a bot token from https://telegram.me/BotFather

```sh
git clone https://github.com/TheReverend403/Piper
cd Piper
virtualenv .venv -p python3
source .venv/bin/activate
pip install -r requirements.txt
cp config.ini.sample config.ini
nano config.ini # Add your bot token
python -m piper.main
```

# Upgrade
```sh
cd Piper
git pull
source .venv/bin/activate
pip install -r requirements.txt
cat config.ini.sample # Check for any new values, add them to config.ini
```

# systemd service
To run Piper as a systemd user service:

```sh
cp piper.service ~/.config/systemd/user
nano ~/.config/systemd/user/piper.service # Edit as needed
systemctl --user daemon-reload
systemctl --user enable piper
systemctl --user start piper
sudo loginctl enable-linger $USER # To allow user services to run on startup and stay after logout.
```

To run Piper as a systemd system service (not recommended):

```sh
sudo cp piper.service /etc/systemd/system
sudo nano /etc/systemd/system/piper.service # Edit as needed
sudo systemctl daemon-reload
sudo systemctl enable piper
sudo systemctl start piper
```
Use newlines in readme rather than new paragraphs
Use newlines in readme rather than new paragraphs
