Information for getting Peach Pi TV operational on your Raspberry Pi 3 (RPi3) Model B Disclaimer: This Peach Pi TV package 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 General Public License for more details. ----------------------------------------------------------------------------------- Important Note: YOU WILL NEED A COMPUTER RUNNING A LINUX SYSTEM LIKE ONE OF OUR PEACH OSI OS's WITH GPARTED INSTALLED AND A WAY TO READ YOUR SD CARD IN ORDER TO FULLY EXPAND YOUR micro SD CARD TO THE FULL AVAILABLE SPACE ON YOUR SD CARD. The Peach Pi TV system files have been intentionally kept to a bare minimum so that streaming video on your Raspberry Pi 3 (RPi3) Model B can be as efficient as possible. This means that there is no desktop system installed in Peach Pi TV and neither is there any applications to expand the partition to whatever he maximum size available on your particular SD card. Peach Pi Tv will function without expanding the partition just fine but your storage capibility will not be the total amount available on your SD card. You can remedy this situation by loading your SD card into a computer with just about any Linux flavor and with Gparted installed and then follow the instructions given below in section number 2 of Normal Operation of your Raspberry Pi 3 (RPi3) Model B using Peach Pi TV. ----------------------------------------------------------------------------------- The File you downloaded is a zip file and we zipped it with 7Zip. Most any zipping program should work to unzip the files. You can download a free copy of 7Zip from here: http://www.7-zip.org/ In the event that you do not have an internet connection the above 7Zip installation program for Windows is in the folder that you unzipped. Use the Hash Check System Included in the zip file is a text file named Hash Check. It is a good practice to always check the original Hash Check against the results that you get from a Hash Check. In Linux you can check the Hash with an application called GTKHash. In Windows you can download a free Hash Check program at: http://download.cnet.com/MD5-SHA-Checksum-Utility/3001-2092_4-10911445.html? In the event that you do not have an internet connection the above Hash Check installation program for Windows is in the folder that you unzipped. ----------------------------------------------------------------------------------- Suggested Usage and Warning: Peach Pi TV was built on a Raspberry Pi 3 (RPi3) Model B Quad-Core 1.2 GHz 1 GB RAM with On-board WiFi and with Bluetooth Connectivity. As of the writing of this help file, Peach OSI has not tested Peach Pi TV on anything other than the previously stated device the Raspberry Pi 3 (RPi3) Model B Quad-Core 1.2 GHz 1 GB RAM. Peach Pi TV should run on a Raspberry Pi 2 (RPi2)900 MHz quad-core ARM Cortex-A7 CPU with 1GB RAM but those devices may experience issues with the config.txt file because the config.txt file has been modified to overclock the Raspberry Pi 3. Users of the Raspberry Pi 2 - if attempting to run Peach Pi TV - should immediately go to the /boot/ folder and delete the config.txt file and replace it with the copy of the default config.txt file that is already stored in the /boot/ directory. Otherwise the existing config.txt file will be running your Raspberry Pi device overclocked with several overclocked settings. If you decide to run Peach Pi TV on any device - especially versions of Raspberry Pi that are not the Raspberry Pi 3 (RPi3) Model B - then you do so at your own risk. Please read through the entire help file before you attempt to install Peach Pi TV on any micro SD card an before running Peach Pi TV on any Raspberry Pi device. Again, by installing Peach Pi TV on any device you agree that you understand that peach OSI has no responsibility for any damages that may result from that or any subsequent installation(s). You also agree that you are doing so AT YOUR OWN RISK. ----------------------------------------------------------------------------------- Importance of using the right micro SD card. Of the foremost importance in using Peach Pi TV on your Raspberry Pi 3 (RPi3) Model B is the size, quality and speed of the SD card that you installed Peach Pi TV on to. We recommend Kingston, Sandisk or Patriot micro SD cards and we also recommend a 32GB SD card in either of those three flavors. Peach Pi TV will run on a 16GB SD card but we have found that the OS is more responsive with a 32GB SD card. We also suggest that you use an SD card with a speed rating of Class 10. Peach Pi TV will run on an 8GB SD card with a rating of 4 but the system will lag seriously without available storage and with such a slow speed class rating. ----------------------------------------------------------------------------------- Burning Peach Pi TV to a micro SD Card ----------------------------------------------------------------------------------- Burn to micro SD card with Windows - Included in the zip file are two programs designed to work with Windows. The first program is SD Formatter and the other is Win32DiskImager. You will need to install both programs into Windows in order to burn the Peach Pi TV image file to your micro SD card. 1.) After installing the two above programs insert your micro SD card into your computer (however way you can access the micro SD card in your computer. I use a USB to micro SD card convertor.) 2.) Next open or run the SD Formatter program. The SD Formatter program should automatically detect your micro SD Card. Make absolutely sure that the drive letter depicted is the correct drive letter for your micro SD card. Click on the "Option" tab inside the SD Formatter program. Leave format type to "QUICK" but on the field labeled "Format Size Adjustment", switch that option to "On" and then click on "OK". Next click on "Format" in the main window. Answer yes to all the warnings and let the SD formatter program do its magic. 3.) Next open or run the Win32 Disk Imager program. The Win32 Disk Imager program should automatically detect your micro SD Card. Make absolutely sure that the drive letter depicted is the correct drive letter for your micro SD card. Click on the small blue folder next to your drive letter and navigate to the location where you have the Peach Pi TV file stored named PeachPiTV.armhf.16.04.LTS.img. Click on that file. Now simply click on "Write"and Win32 Disk Imager will write the Peach Pi TV image file to your micro SD card. Lastly, be sure to properly remove the micro SD card from the system and you should be good to install Peach Pi TV into your Raspberry Pi and boot with it. Be sure to expand the storage capability in the micro SD card as per the instructions in part 2 below in the section entitled "Normal Operation of your Raspberry Pi 3 (RPi3) Model B using Peach Pi TV. ----------------------------------------------------------------------------------- For Linux - 1.) Copy the Peach Pi TV image file (named: PeachPiTV.armhf.16.04.LTS.img) to the root of your (username) - (whatever username your Linux favor was installed with) folder. This folder is located in the /home/(username) folder. 2.) Insert your micro SD card into your computer (however way you can access the micro SD card in your computer. I use a USB to micro SD convertor.) 3.) If you need to format the micro SD card (such as a previously used micro SD card) in Linux we will use the fdisk commands. In a terminal, start fdisk /dev/sdx where /dev/sdx is your SD card device (may depend on the Linux distro you're using, see what's to follow). You can then delete all existing partitions on the device by typing d, and then adding a single new partition & format it. You an also just type n to create a new partition table, and start laying everything out. cfdisk is also another viable tool, which is basically fdisk with a greatly improved user interface. In both cases, once the drive is formatted, you will lastly need to mount it. If you're unable to determine the proper device, remove the SD card, run fdisk -l, and then re-run it with the SD card inserted. The micro SD card is the device that has been added. 4.) Your micro SD card needs to be unmounted so open a terminal and type (close any open windows that show the files installed on the micro SD card). sudo umount /dev/sdb1 /dev/sdb2 Remember you may need to change /dev/sdb , /dev/sdb1 and /dev/sdb2 depending where your system mounts your cards. It could be sde, sdc, etc. Just make sure that you do not use sda as that is your permanently installed hardrive or SSD drive. Again if you're unable to determine the proper device, remove the SD card, run fdisk -l, and then re-run it with the SD card inserted. The micro SD card is the device that has been added. If your version of Linux does not have dcfldd already installed for making card images, which is a replacement for the old dd disk duplication program, then you should install it now. dcfldd has a number of improvements, most notably a progress meter so you can see it working, and be confident that it hasn't crashed. Install dcfldd if you haven't already got it (it won't hurt to try to install it again if you already have it): In a terminal enter - sudo apt-get update && sudo apt-get install dcfldd Then type into the terminal to load the image onto your micro SD card. sudo dcfldd if=PeachPiTV.armhf.16.04.LTS.img of=/dev/sdb Again, remember you may need to change /dev/sdb depending where your system mounts your cards. It could be sde, sdc, etc. Just make sure that you do not use sda as that is your permanently installed hardrive or SSD drive. If the dcfldd command cannot find the PeachPiTV.armhf.16.04.LTS.img you will get an error messange stating the file is not found. Make sure that you have copied the file PeachPiTV.armhf.16.04.LTS.img to the /home/"username" directory in your Linux flavor and it should be placed in that directory along with the folders like "Desktop", "Documents", "Pictures", etc. After the transfer completes give it a couple of minutes to be sure everything is completely transfered and then in the terminal type sudo sync to clear the registers and then type into the terminal sudo shutdown -r now to shutdown your Linux PC. It is now safe to remove the micro SD card and install it into your Raspberry Pi 3 (RPi3) Model B. ----------------------------------------------------------------------------------- Normal Operation of your Raspberry Pi 3 (RPi3) Model B using Peach Pi TV While using Peach Pi TV on your Raspberry Pi 3 (RPi3) Model B you should follow these guidelines to help to make the most of your experience with Peach Pi TV on your Raspberry Pi 3 (RPi3) Model B. 1. Given that Peach Pi TV is built based a version of our Peach OSI – an Xubuntu derivative called Peach OSI Barebones along with another distro named OSMC – Peach Pi TV is designed to give the user a full TV experience without having to know or learn the nuances of a Raspberry Pi or the Linux operating system. In running Peach Pi TV you need to be aware that your Raspberry Pi 3 (RPi3) Model B has been slightly overclocked and that several other features for the Raspberry Pi 3 (RPi3) Model B have been optimized. These changes are made in the /boot/config.txt and /boot/cmdline.txt files and can be further altered you if should decide to do so. We have made backups of both default files and you can replace the current functioning file with the backup copy to return your Raspberry Pi 3 (RPi3) Model B to its default status. 2. You may want to expand the PI Root partition so that you can utilize any and all of the space on your micro SD card. For this process you will need a separate functioning computer running some Linux variant with Gparted installed as we will use the Gparted application. (It is necessaryto be running a Linux system because we are going to be working with a Linux ext4 partition) If using any Peach OSI Linux variant open Gparted by clicking on “Applications” in the taskbar in the upper left of your screen. In the window that type in Gparted in the search window at the top. Click on Gparted and give the password to open Gparted. In Gparted – right click on the listed devices on the listed items in the top right corner of the Gparted application and select the correct sdb or sdc or sde device or whichever selection is your micro SD card. Be sure you know exactly which option is your SD card. It will never be sda as that is your hardrive that Peach OSI is installed to. One easy way to tell is by the size of your micro SD card. Once you have the absolute correct device selected the available partitions for that device will show in the main window. In the main window you should see 2 partitions. One should be a fat32 partition and the other should be an ext4 partition. (If you can't see both a Fat32 and an ext4 partition then you are not looking at the correct device - do your search over in the upper right hand device search window in Gparted). Left click on the ext4 partition to highlight that partition. Now right click while hovering over the selected ext4 partition. In the window that opens, click on “Resize/Move”. In the upper right of the window that opens you can see the heading “Maximum Size”. Fill in the box that reads “New Size” with the amount you can read in the “Maximum Size” data. Once you have “New Size” filled in properly click on the next box below beside of the words “Free Space Following (MiB) and the box should automatically populate to zero. If not then enter a numerical 0. Then click on “Resize” on the button on the lower right of the open window. You're not finished yet though. You must apply the changes. To apply the changes click on the green check mark in the menu near the top. Verify you want to make the changes and Gparted will do the rest. When Gparted finishes close Gparted and shut down your PC before removing the micro SD card. Install your micro SD card into your Raspberry Pi 3 (RPi3) Model B. You should now have full access to all the space that's available on your micro SD card. 3. Connecting Peach Pi TV to Ethernet and/or your WiFi. Peach Pi TV has OSMC installed along with Kodi and many other specialized Peach Pi TV setup files. You will need to give your Peach Pi TV internet access by either accessing your WiFi or by a hard wired Ethernet connection. I highly suggest an Ethernet connection if this is possible for you as your Peach Pi TV is capable of streaming Hi Definition 1080p and that quality of streaming will require a higher speed Ethernet connection for streaming high 720p or 1080p quality HD video. You will most likely have streaming buffering issues if you are on only WiFi. This is not just an issue with the Raspberry Pi 3 (RPi3) Model B, you would have this same issue with a high end Home Entertainment Center PC. How do I know? I have several and I would never consider watching any streamed content of any kind without an Ethernet connection. I connect both an Ethernet cable and create a Wifi connection as well. It's like having two separate connections and I rarely have any buffering issues no matter what the quality of video is that I am streaming or to how many TV's or different programs that may be being watched simulataneously. Of course your results may vary as it is also important on how fast your internet connection speeds are. As for how the Raspberry Pi 3 (RPi3) Model B with Peach Pi TV performs and compares to the other full blown PCs that I have - as far as streaming video - there is no difference at all. None. Nada. Settng up your Wi-Fi connection or Ethernet connection or Bluetooth on Peach Pi TV You will need some type of a USB keyboard and mouse to perform the following While in Peach Pi TV navigate right to the "System" category Click on System and then on "Appearance" in the window that opens Now click on "Skin" in the window on the right and wait for the skin options to populate - you have three available options - Confluence (the standard Kodi Skin), Convergence (the Peach Pi TV Skin with Peach enhancements) and OSMC (The configuartion of Peach Pi TV). Click on OSMC. Then "Yes" to keep the OSMC skin. Now hit escape twice, then click on "My OSMC". A graphical window will open and here is where you can set many options for your Raspberry Pi 3 (RPi3) Model B. You want to click on the graphic of three small circles connected with 2 lines. This is the Network settings module. In the window that options you can turn on Ethernet and turn on Wifi and turn on Bluetooth to your Raspberry Pi 3 (RPi3) Model B. All of these settings are simple and self explanatory. For Ethernet all you usually need to do is to turn it on unless you have to setup Ethernet manually and you should know how you manually do that. For WiFi you simple switch (click on 'Wireless") and then select to turn on the WiFi (should already be on), select your WiFi network and give your Peach Pi TV your WiFi password or key. I do not turn on Bluetooth as turning on Bluetooth uses more resources and as I'm sure you are aware, resources with the Raspberry Pi 3 (RPi3) Model B are always at a premium. When you've finished setting up your Network options - hit escape twice nd then select "Settings" on the bottom of the list. Then select "Appearance" and then on "Skin" in the left window and then set the skin back to "Convergence" and approve the selection and your done. 4. Peach Pi TV has been pre-setup to work with any basic MCE remote - Media Center Remote. Other settings or other remotes are pre-installed as well. Email us for information about any other remote control. 5. Always be sure to properly shut down your Raspberry Pi 3 (RPi3) Model B. Do not unplug the power cable until you’ve properly shut down Peach Pi TV. The easiest way to shut down Peach Pi TV is to click or navigate to the power button located on the bottom left of your screen. A window will open with the shutdown options. This is most important because failing to properly shut down your Raspberry Pi 3 (RPi3) Model B can severely corrupt your Micro SD card. For turning off your Raspberry Pi I recommend a Wideskall 2 Prong AC Power Wall Plug On / Off Switch Tap Adapter ETL Certified as the USB on/off switch sold for Raspberry Pi often drains energy from the cables on the Raspberry Pi. The Wideskall 2 Prong AC Power Wall Plug On / Off Switch Tap Adapter ETL Certified costs less than $6 US and you can get one here: https://www.amazon.com/Wideskall-Prong-Switch-Adapter-Certified/dp/B019JJV12I/ref=sr_1_1?s=baby-products&ie=UTF8&qid=1477679348&sr=8-1&keywords=wall+tap+with+switch 6. Once completing the above steps you are ready to load up your Peach Pi TV with any addons as you would with any other Kodi install. We do not pre-load any blacklisted Kodi addons for obvious reasons. Please read our file about using Kodi addons included with your Peach Pi TV download. Final note: For remote controls of your Peach Pi TV I use an Ortek Windows 7 Vista XP Media Center MCE PC Remote Control and Infrared Receiver for under $13 US and available here: https://www.amazon.com/gp/product/B00224ZDFY/ref=oh_aui_search_detailpage?ie=UTF8&psc=1 For a neat portable keyboard with track pad I use the a Rii 2.4GHz BACKLIT Wireless Mini Kodi Keyboard with Touchpad Mouse for under $23 and available here: https://www.amazon.com/gp/product/B00Z81U3YY/ref=oh_aui_search_detailpage?ie=UTF8&psc=1 I am not affiliated with any of these products - I'm just saying that if you need a handy on/off switch, a wireless remote that is pre-setup to work with Peach Pi TV, and a handy wireless keyboard - these are what I personally use but I am neither endorsing the products nor do I give support for using said products. ----------------------------------------------------------------------------------- I hope you enjoy the world of Raspberry Pi computing and if I can ever be of any further assistance, please do not hesitate to ask. Any and all contact should be initiated through our website located at www.peachosi.com.