rpi-curious / screenrc

collection of scripts and configurations for setting up `screen` on Raspberry Pi

screenrc Tips

screenrc, contains a collection of scripts and configurations for setting up screen on Raspberry Pi. The following covers how to install this branch within Linux user account.

---

Table of Contents

• ⬆ Top of ReadMe File

• ⚡ Quick Start

• 🗒 Notes

• 📇 Attribution

• ©️ License

---

Quick Start

Installing

1. Make a directory for Git sources and clone this project

2. Symbolically link configuration file

3. Symbolically link scripts directory

mkdir -vp ~/git/rpi-curious
cd ~/git/rpi-curious
git clone [email protected]:rpi-curious/screenrc.git

mkdir -vp ~/bin
ln -s "${HOME}/git/rpi-curious/screenrc/screenrc" "${HOME}/.screenrc"

mkdir -vp ~/.screenrc-scripts
ln -s "${HOME}/git/rpi-curious/screenrc/screenrc-scripts" "${HOME}/.screenrc-scripts"

Starting a new screen session should something similar to...

screen -RD ssh


53c pi@raspberrypi ssh |   | Free Mem: 59% Swap: 83% Disk: 72% | 2019/08/15 10:57

... along the bottom of the terminal window.

Updating

1. Change directories to repository

2. Pull changes from default remote

cd ~/git/rpi-curious/screenrc

git pull

Customizing

1. Change directories to repository and checkout a local branch

2. Make changes to a file

3. Add and commit for Git to track changes on the local branch

cd ~/git/rpi-curious/screenrc
git checkout -b local-edits

vim screenrc-scripts/cpu-temp.sh

git commit add screenrc-scripts/cpu-temp.sh
git commit -F- <<'EOF'
:shell: Adds Kelvin support
# ... Three blank lines and then other
#     comment-worthy notes maybe...
EOF

---

Notes

This project is designed and tested on Raspberry Pi development boards, however, there's likely little reason that it will not work properly on other platforms, perhaps even without modifications.

---

Attribution

• screenrc

  • GNU -- screen String Escapes
  • Gist -- .screenrc from @roylez

• cpu-temp.sh

  • Unix StackExchange -- How can I tell if I'm in a tmux session from a bash script?

• free-mem

  • Unix StackExchange -- How to do integer & float calculations in bash or other languages/frameworks?
  • Arch Linux -- Post your .screenrc with screenshots!

---

License

Legal bits of Open Source software

`screenrc` Tips documentation
Copyright (C) 2019  S0AndS0

This program is free software: you can redistribute it and/or modify
it under the terms of the GNU Affero General Public License as published
by the Free Software Foundation; version 3 of the License.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU Affero General Public License for more details.

You should have received a copy of the GNU Affero General Public License
along with this program.  If not, see <https://www.gnu.org/licenses/>.