Portable mode: Difference between revisions

From Official Kodi Wiki
Jump to navigation Jump to search
(Add content)
No edit summary
Line 21: Line 21:
# Create a shortcut to kodi.exe. Usually by right clicking on the kodi.exe file and selecting ''Send to'' then ''desktop (create shortcut)''
# Create a shortcut to kodi.exe. Usually by right clicking on the kodi.exe file and selecting ''Send to'' then ''desktop (create shortcut)''
# Right click on the newly created shortcut and select ''Properties''. In ''Target:'', add the switch ''-p'' after kodi.exe i.e. '''"E:\Kodi\kodi.exe" -p''' and save the change (see image)
# Right click on the newly created shortcut and select ''Properties''. In ''Target:'', add the switch ''-p'' after kodi.exe i.e. '''"E:\Kodi\kodi.exe" -p''' and save the change (see image)
# Start Kodi. This will create a '''portable_data''' folder within the portable installation folder. This folder is the equivelant of the '''[[Kodi data folder]]''' created in standard installations.
# Go to your start menu and locate the newly created entry for your portable install (it will be under new name you gave the install). Right click on the Kodi shortcut there (do not run it!), select properties and make the same -p change as above.
# Start Kodi (via either the shortcut or the newly modified start menu entry). This will create a '''portable_data''' folder within the portable installation folder. This folder is the equivelant of the '''[[Kodi data folder]]''' created in standard installations.


'''Note''': It is this shortcut that enables Portable Mode. If you create another shortcut and fail to add the '''-p''' switch, or start this portable version of {{kodi}} in another manner, then the standard userdata folder will be created which may overwrite your existing installation of {{Kodi}}.<section end="PortableMode" />
'''Note''': It is this shortcut that enables Portable Mode. If you create another shortcut and fail to add the '''-p''' switch, or start this portable version of {{kodi}} in another manner, then the standard userdata folder will be created which may overwrite your existing installation of {{Kodi}}.<section end="PortableMode" />

Revision as of 10:05, 22 November 2020

Home icon grey.png   ▶ Installing ▶ Portable mode


Introduction

Kodi can be installed as a portable application (portable install or portable mode) on MS Windows and, with caveats, on macOS. Other platforms do not support portable installations.


MS Windows

Portable01.jpg

If you have a requirement to run a different version of Kodi or multiple of the same version without removing your current installation, Kodi has the ability to run in portable mode.

Follow these steps to install additional Kodi setups on the same computer.

  1. Download required version of Kodi and run the Installation
  2. During the installation process you will be prompted to specify the install location. This must be changed from the default location offered. Install to...
    • A removable USB device, or
    • Another folder or hard drive on your computer where standard users have write permission (e.g. not under Program Files)
  3. Once the Install has finished do not run Kodi until the remainder of these steps have been completed.
  4. Navigate to where you just installed Kodi and look for the file kodi.exe
  5. Create a shortcut to kodi.exe. Usually by right clicking on the kodi.exe file and selecting Send to then desktop (create shortcut)
  6. Right click on the newly created shortcut and select Properties. In Target:, add the switch -p after kodi.exe i.e. "E:\Kodi\kodi.exe" -p and save the change (see image)
  7. Go to your start menu and locate the newly created entry for your portable install (it will be under new name you gave the install). Right click on the Kodi shortcut there (do not run it!), select properties and make the same -p change as above.
  8. Start Kodi (via either the shortcut or the newly modified start menu entry). This will create a portable_data folder within the portable installation folder. This folder is the equivelant of the Kodi data folder created in standard installations.

Note: It is this shortcut that enables Portable Mode. If you create another shortcut and fail to add the -p switch, or start this portable version of Kodi in another manner, then the standard userdata folder will be created which may overwrite your existing installation of Kodi.


macOS

Stop hand.png Portable mode is recommended for testing/development on macOS by advanced users only. During updates, app bundles will replace the entire existing bundle, and any portable data will be lost.


osX 10.6.2 introduced the ability to provide arguments using open to execute an application bundle. This feature has been added to Kodi v19- Matrix.[1]

In a terminal window execute the following command

open <location_to_app_bundle>/Kodi.app --args -p


References


Return to top