More details in rtmplite
This project was migrated from https://code.google.com/p/rtmplite on May 17, 2015
Please see these individual description files for rtmplite
Copyright (c) 2007-2009, Mamta Singh.
Copyright (c) 2010-2011, Kundan Singh. All rights reserved.
Copyright (c) 2011-2012, Intencity Cloud Technologies. All rights reserved.
Copyright (c) 2011, Cumulus Python. No rights reserved.
See contributors.
This repo aims to upgrade the original repo from Python 2 to Python 3, as well as integrate into my self-host video streaming project. Therefore, only rtmp.py and its dependencies will be modified in this repo.
I am working on a self-host video streaming project with Python 3 and Flask, hence, I need a Python 3 RTMP server. However, most of the Python RTMP solution do not match what I need (developed using Python 2, no longer maintained etc.), so, I decided to transit a Python 2 solution to Python 3.
This repo has three branches including master, dev and svs (self-host streaming).
- master: release branch; stable
- dev: development branch; maybe buggy or even can't run at all
- svs: customized branch for self-host video streaming project
The main program is rtmp.py. Please see the embedded documentation in that file. Some parts of the documentation are copied here. Other modules such as amf, util and multitask are used from elsewhere and contain their respective copyright notices.
Instead of looking at the documentation from the source code, I migrated (or migrating) the embedded documentation from the source code to Wiki of this repo.
Dependencies: Python 3.6+
Tested environment:
- Windows 10 1803 with Python 3.8.3rc1
- Ubuntu 18.04.4 LTS with Python 3.6.9.
Typically an application can launch this server as follows:
$ python rtmp.py -d
The -d option enables debug trace so you know what is happening in the server.
There is also a -v option which enables verbose mode so you know all data sent and received in Hex. Please note that verbose mode will hugely affect the performance of the RTMP server
To know the command line options use the -h option:
$ python rtmp.py -h
For your convenience, this repo also provide you a single executable. You may want to check out our release page.
And here is how to use the executable
# in Linux
$ chmod +x rtmp-Linux
$ ./rtmp-Linux
:: in Windows
> rtmp-Windows.exe
or double click the file
- The program cannot exit with Control+C in Windows
- Viewer cannot join the stream after the feed started to broadcast
If you want to help me to improve the quality of this project, you can submit an issue.
If you want to collaborate with us, feel free to Fork this project and open a pull request.
-
For Issue
- Report any Logical Error.
- Report any Run-Time Error.
- Request new features
- Ask questions if you do not understand something.
-
For Pull request
- Add comments to source code.
- Add new features
- Correct any Logical Error.
- Correct any Run-Time Error.