ShumanLab / Chronotate

Other
4 stars 0 forks source link

Help required to install tkvideoplayer on mac #3

Open Abderaouf1998 opened 2 months ago

Abderaouf1998 commented 2 months ago

Hello,

We are having trouble installing the modified version of tkvideoplayer on mac. As we have minimal coding experience, it would be appreciated if we could get guidance on how to exactly to install it, especially because we intend to use the software for a large data set.

pphilipsberg commented 2 months ago

Hello, I realize that the installation instructions in the readme for the source version are not very beginner friendly. To address this, I have created a step-by-step guide, copied below, that has just been added to the wiki on this repository. There is no installation required for the modified tkvideoplayer as long as the tkVideoPlayer folder from this repository is present in the directory containing the ‘Chronotate.py’ script. Following the instructions below should ensure that the directory structure is set up correctly. In testing these instructions, an issue was discovered where the latest version of pyAV can cause errors in seeking to specific timestamps. To solve this specify version 11 when installing av as illustrated in the below guide.

Step-by-step guide for installing Chronotate on macos:

  1. If Anaconda is not already installed, follow the instructions here to install: https://docs.anaconda.com/free/miniconda/miniconda-install/
  2. Clone or download the Chronotate repository from gitub
  3. Unzip the folder to a convenient directory
  4. Turn off keyboard repeat in your operating system settings (steps to do so may vary depending on OS)
    a. Apple menu > System Settings, then click Keyboard in the sidebar
    b. Drag ‘keyboard repeat rate’ slider to ‘off’
  5. Launch a conda terminal
  6. Create a conda environment using the command: conda create --name chronotate
    a. By default this should create a python 3 environment with python 3, tkinter (tk), and pip installed
  7. Activate the new conda environment using: conda activate chronotate
  8. Type the following commands to install the remaining dependencies:
    a. conda install pandas
    b. conda install pillow
    c. pip install av==11
    d. if pip was not installed by default in step 4, install with: conda install pip
  9. use cd command to change directory to the unzipped folder from step 3: a. ex: cd /Users/Username/Desktop/Chronotate-main
  10. run chronotate with: python Chronotate.py
  11. click the customize key binds button
  12. set the keboard shortcut for each function by clicking the relevant button and then tapping the desired key
  13. Load a sample video to confirm successful installation