Skip to content

skglobal-jsc/kivyrtc

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

8 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Kivy RTC

A simple video call for Kivy use aiortc.

  • Note:

    • Use python 3.7 or above.
    • Currently, mobile is not supported.
    • Camera use OpenCV, not use kivy camera provider.
    • Have some problems when handling audio.

TODO:

  • Add new app icon in kivyrtc/data (replace existing file) and remove this todo.
  • Generate a new GUID for Inno setup when create new project and remove this todo.
  • When change version, remember change in files: main.py and buildtools/create-installer.iss
  • When you release app please change IS_RELEASE in utils/platform.py to True and remember change back to False when done it.

Usage

Launching the app

  • Create env:
# On Mac, Linux
pip3 install --upgrade virtualenv
python3 -m virtualenv .env
source ./.env/bin/activate

# On Windows
py -3 -m pip install --upgrade virtualenv
py -3 -m virtualenv .env
.\.env\Scripts\activate
  • Install lib:

    • On OS X run:
    brew install ffmpeg opus libvpx pkg-config
    • On Windows:

      • Download Microsoft C++ Build tools to build PyAV, aiortc and opus.
      • You can copy include, lib folders in win-lib to .env, to avoid following the steps below.
      • Dowload libvpx and ffmpeg(shared and dev) or build it yourself.
      • Extrack it and copy all content in folder include to .env\Include and lib to .env\libs.
      • Copy path/to/lib/bin to os.environ["PATH"] in main.py.
      • For opus you have to build it yourself because I can't find any builds. Download source opus and extrack it in %USERPROFILE%.
      • Open opus-1.3.1\win32\VS2015\opus.vcxproj, find and add SDK version to:
      <PropertyGroup Condition="'$(Configuration)|$(Platform)'=='ReleaseDLL|x64'" Label="Configuration">
      <ConfigurationType>DynamicLibrary</ConfigurationType>
      <PlatformToolset>v140</PlatformToolset>
      <WindowsTargetPlatformVersion>Your Windows SDK version</WindowsTargetPlatformVersion>
      </PropertyGroup>
      • Build it by Command Prompt for VS: msbuild "opus-1.3.1\win32\opus.vcxproj" /property:Configuration=ReleaseDLL;Platform=x64 /m /v:minimal
      • Copy x64\ReleaseDLL\opus.lib to .env\libs, opus-1.3.1\Include to .env\Include and add path/to/x64/ReleaseDLL/opus.dll to os.environ["PATH"].
  • Install requirements and run:

pip install -r requirements.txt
python main.py

Packaging project

Make sure you follow all steps in Environment preparing and check all TODO

  • For Windows/MacOS, you must activate env and run pyinstaller:
    • Output folder will save in dist folder.
    • You must close app and the opened file or folder in dist folder before packaging app. If you not, pyinstaller can't build project.
# On Mac, Linux
source ./.env/bin/activate
# On Windows
.\.env\Scripts\activate
pyinstaller ./desktop.spec
  • To create installer:
    • Windows: download Inno Setup and run .\buildtools\create-installer.iss. Output file will save in .\buildtools\Output folder.
    • Mac: run cmd pkgbuild --install-location /Applications --component 'dist/Kivy RTC.app' 'dist/Install Kivy RTC v0.1.0.pkg'

If you get error, read this to fix it or contact to [email protected] for further instructions.

Copyright Notice

Copyright (C) 2019 Spring Knowledge Global,.JSC. All rights reserved.

Licensed under the MIT license (see the LICENSE file).

Releases

No releases published

Packages

No packages published

Languages