# @treehouses/cli [![Build Status](https://travis-ci.org/treehouses/cli.svg?branch=master)](https://travis-ci.org/treehouses/cli) [![npm version](https://badge.fury.io/js/%40treehouses%2Fcli.svg)](https://www.npmjs.com/package/%40treehouses%2Fcli) [![npm](https://img.shields.io/npm/dw/@treehouses/cli)](https://www.npmjs.com/package/%40treehouses%2Fcli) [![Gitter](https://badges.gitter.im/Join%20Chat.svg)](https://gitter.im/treehouses/Lobby?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge) ## About @treehouses/cli is a command-line interface for Raspberry Pi that is used to manage various services and functions. Including vnc, ssh, tor, vpn, networking, starting services, bluetooth, led lights, and much more! Also [treehouses remote](https://github.com/treehouses/remote) uses this interface. ## Install @treehouses/cli comes pre-installed on the treehouses image made with [builder](https://github.com/treehouses/builder). To manually install on a Pi: ```bash sudo curl -sL https://deb.nodesource.com/setup_10.x | sudo bash - sudo apt-get install -y nodejs sudo npm i -g --unsafe-perm @treehouses/cli ``` If you run into any problems check if your RPi is supported [here](https://github.com/treehouses/cli/blob/836c2e9b0bcebfe6afc97706634e7c070d795eac/modules/detect.sh#L5-L42). ## Features ``` Usage: treehouses [command] ... Commands: help [command] gives you a more detailed info about the command or will output this verbose makes each command print more output (might not work with treehouses remote) expandfs expands the partition of the RPI image to the maximum of the SD card rename changes hostname password changes the password for 'pi' user or disables/enables password authentication sshkey used for adding or removing ssh keys for authentication version [contributors|remote] returns the version of treehouses CLI, remote, or list of contributors image returns version of the system image installed detect [bluetooth|rpi|arm|arch|wifi] detects the hardware version of any device ethernet configures rpi network interface to a static ip address discover performs network scan and discovers all raspberry pis on the network [ipaddress|url|macaddress] [list] wifi [password] [identity] connects to a wifi network wifihidden [password] [identity] connects to a hidden wifi network tether enable usb0 interface tethering staticwifi configures rpi wifi interface to a static ip address [password] wifistatus displays signal strength in dBm and layman nomenclature bridge configures the rpi to bridge the wlan interface over a hotspot [password] [hotspotPassword] config [update|add|delete|clear] commands for interacting with config file container enables (and start) the desired container bluetooth [on|off|pause|restart|button] switches bluetooth from regular to hotspot mode and shows id or MAC address [mac|id|status|log] ap [password] creates a mobile ap, which has two modes: local (no eth0 bridging), internet (eth0 bridging) aphidden creates a hidden mobile ap with or without internet access [password] apchannel [channel] sets or prints the current ap channel timezone sets the timezone of the system locale sets the system locale ssh [on|off|fingerprint] enables or disables the ssh service, [2fa] prints out fingerprint of the ssh daemon and deals with two factor authentication vnc [on|off|info|auth|password] enables or disables the vnc server service default [network|notice|tunnel] sets a raspbian back to default configuration wificountry sets the wifi country upgrade [tag|check|bluetooth|force|cli] upgrades treehouses package using npm sshtunnel [add|remove|list|active|check] helps adding sshtunnels [key|refresh|notice|ports] led [green|red] [mode] sets the led mode [newyear|blackhistorymonth] [lunarnewyear|valentine|carnival] [lantern|stpatricks|easter|labourday] [eid|dragonboat|independenceday|onam] [diwali|thanksgiving|christmas] [heavymetal|dance|kecak|sandstorm] [random] power [mode|current|freq|status] sets the power mode or check power mode/CPU frequency uptime [boot|start|stop|log] displays uptime and boot time of the Raspberry Pi rtc [rasclock|ds3231] sets up the rtc clock specified ntp sets rpi to host timing locally or to get timing from a remote server networkmode outputs the current network mode button gives the gpio pin 18 an action feedback sends feedback clone [detect|device path] clones the current SD Card onto a secondary SD Card or specified device restore [device path] restores a treehouses image to an SD Card or specified device burn [device path] download and burns the latest treehouses image to the SD card or specified device rebootneeded shows if reboot is required to apply changes reboots reboots at given frequency | removes it if reboot task active internet [reverse] checks if the rpi has access to internet services executes the given command on the specified service list available, and installed services list ports used by services and services running [planet] Planet Learning is a generic learning system built in Angular & CouchDB [kolibri] Kolibri is a learning platform using DJango [nextcloud] Nextcloud is a safe home for all your data, files, etc [netdata] Netdata is a distributed, real-time performance and health monitoring for systems [mastodon] Mastodon is a free, open-source social network server [moodle] Moodle is a learning management system built in PHP [pihole] Pi-hole is a DNS sinkhole that protects your devices from unwanted content [privatebin] PrivateBin is a minimalist, open source online pastebin [portainer] Portainer is a lightweight management UI for Docker environments [ntopng] Ntopng is a network traffic probe that monitors network usage [couchdb] CouchDB is an open-source document-oriented NoSQL database, implemented in Erlang [mariadb] MariaDB is a community-developed fork of the MySQL relational database management system [mongodb] MongoDB is a general purpose, distributed, document-based, NoSQL database [seafile] Seafile is an open-source, cross-platform file-hosting software system [turtleblocksjs] TurtleBlocks is an activity with a Logo-inspired graphical "turtle" that draws colorful art [musicblocks] MusicBlocks is a programming language for exploring musical concepts in an fun way [minetest] Minetest is an open source infinite-world block sandbox game engine with survival and crafting [invoiceninja] Invoiceninja is the leading self-host platform to create invoices [librespeed] Librespeed is a very lightweight Speedtest implemented in Javascript [grocy] Grocy is a web-based, self-hosted groceries and household management utility for your home [dokuwiki] Dokuwiki is a simple to use and highly versatile Open Source wiki software [bookstack] Bookstack is a free and open source Wiki designed for creating beautiful documentation [transmission] Transmission is a BitTorrent client with many powerful features [piwigo] Piwigo is a photo gallery software to publish and manage your collection of pictures [cloud9] cloud9 is a complete web based ide with terminal access [jellyfin] Jellyfin is a Free Software Media System that puts you in control of managing and streaming your media [pylon] Pylon is a web based integrated development environment built with Node.js as a backend [rutorrent] Rutorrent is a popular rtorrent client with a webui for ease of use [webssh] Webssh is a simple web application to be used as an ssh client to connect to your ssh servers [sysmon] Sysmon is an intuitive system performance monitoring and task management tool for servers [epaath] Epaath is an interactive educational activity tor [list|ports|add|delete|deleteall] deals with services on tor hidden network [start|stop|destroy|notice] [status|refresh] bootoption [autologin] sets the boot mode openvpn [use|show|delete] helps setting up an openvpn client [notice|start|stop|load] shadowsocks [list|add|enable|start] manage shadowsocks, a socks5 proxy designed [enter|disable|stop|remove] to "protect" your Internet traffic coralenv [install|demo-on|demo-off] plays with the coral environmental board [demo-always-on] memory [total|used|free] [gb|mb] displays the total memory of the device, the memory used as well as the available free memory storage [total|used|free] [gb|mb|kb] displays the total storage of the device, the storage used as well as the available free storage temperature [celsius|fahrenheit|kelvin] displays raspberry pi's CPU temperature speedtest tests internet download and upload speed camera [on|off|detect|capture|record] enables and disables camera, detects camera module version, captures photo, records video picture [file|url] displays a picture in the terminal cron [list|add|delete|deleteall] adds, deletes a custom cron job or deletes, lists all cron jobs [0W|tor|timestamp] adds premade cron job (or removes it if already active) usb [on|off] turns usb ports on or off redirect [add|list|remove|start] redirects internet hostnames to rpi remote helps with treehouses remote android app log <0|1|2|3|4|show|max> gets/sets log level and shows log blocker <0|1|2|3|4||max> website blocking levels using /etc/hosts sdbench displays read and write speed of micro SD card inspire [fact|joke|qotd|random] displays quote based on user input convert converts video and audio files gpio displays raspberry pi model and corresponding GPIO ports changelog [view|compare] displays the most recent changes to treehouses magazines downloads specific magazine issue as a pdf based on user input lists the available magazine types, lists downloaded magazines in a tree format [all] downloads all issues of magazine [latest] downloads latest issue of magazine [number] downloads issue [number] of magazine [list] lists downloaded magazines in tree format of specific magazine [url] shows the homepage URL of magazine resolution sets the screen resolution depending on the attached display device system [cpu|ram|disk|volt|temperature] display real system informations message sends message to chat service sets api/channel info in config file sends/recieves messages in gitter sets api/channel info in config file sends/recieves messages in slack sets api/channel info in config file shutdown [now|in|force] shutdown the system ``` ## Additional README's - [Services](https://github.com/treehouses/cli/tree/master/services/README.md) - [Tests](https://github.com/treehouses/cli/tree/master/tests/README.md) ## Add a new feature Feel free to make a pull request to our repository. Remember the following files will have to be updated to add a feature: ``` /modules/help.sh # help text README.md # readme _treehouses # tabcompletion /modules/ # bash /tests/ # bash bats tests ```