tsMuxer/README.md
Dan a2d86bf712
Create README.md
first instance of the readme
2019-07-15 16:43:14 +01:00

4.6 KiB
Raw Blame History

tsMuxer

Vision

This project is for tsMuxer - a transport stream muxer for remuxing/muxing elementary streams. This is very useful for transcoding and this project is used in other products such as Universal Media Server.

EVO/VOB/MPG, MKV/MKA, MP4/MOV, TS, M2TS to TS to M2TS.

Supported video codecs H.264/AVC, H.265/HEVC, VC-1, MPEG2. Supported audio codecs AAC, AC3 / E-AC3(DD+), DTS/ DTS-HD.

Some of the major features include:

  • Ability to set muxing fps manually and automatically
  • Ability to change level for H.264 streams
  • Ability to shift a sound tracks
  • Ability to extract DTS core from DTS-HD
  • Ability to join files
  • Output/Author to compliant Blu-ray Disc or AVCHD
  • Blu-ray 3D support

Ethics

This project operates under the W3C's Code of Ethics and Professional Conduct:

W3C is a growing and global community where participants choose to work together, and in that process experience differences in language, location, nationality, and experience. In such a diverse environment, misunderstandings and disagreements happen, which in most cases can be resolved informally. In rare cases, however, behavior can intimidate, harass, or otherwise disrupt one or more people in the community, which W3C will not tolerate.

A Code of Ethics and Professional Conduct is useful to define accepted and acceptable behaviors and to promote high standards of professional practice. It also provides a benchmark for self evaluation and acts as a vehicle for better identity of the organization.

We hope that our community group act according to these guidelines, and that participants hold each other to these high standards. If you have any questions or are worried that the code isn't being followed, please contact the owner of the repository.

Language

tsMuxer is written is C++. Specifically it was written for Windows on Visual C++ 2008. It can also be compiled for Linux and Mac.

History

This project was created by Roman Vasilenko, with the last public release 20th January 2014. It was open sourced on 15th July 2019, to aid the future development.

Installation

All executable are created to be portable, so you can just save and extract the compressed package for your platform.

Contributing

Were really happy to accept contributions from the community, thats the main reason why we open-sourced it! There are many ways to contribute, even if youre not a technical person.

Were using the infamous simplified Github workflow to accept modifications (even internally), basically youll have to:

  • create an issue related to the problem you want to fix (good for traceability and cross-reference)
  • fork the repository
  • create a branch (optionally with the reference to the issue in the name)
  • hack hack hack
  • commit incrementally with readable and detailed commit messages
  • submit a pull-request against the master branch of this repository

Well take care of tagging your issue with the appropriated labels and answer within a week (hopefully less!) to the problem you encounter.

If youre not familiar with open-source workflows or our set of technologies, do not hesitate to ask for help! We can mentor you or propose good first bugs (as labeled in our issues). Also welcome to add your name to Credits section of this document.

Submitting bugs

You can report issues directly on Github, that would be a really useful contribution given that we lack some user testing on the project. Please document as much as possible the steps to reproduce your problem (even better with screenshots).

Building

To build the project you will need a machine for your chosen platform. Then for Linux or Mac run:

make

On Windows you need to Build the Visual C++ project.

Financing

We accept donations and we have a bounty program to develop some big features:

  • A plugin architecture - 3000€
  • Accepting custom themes - 1000€

Please contact us if you want to collaborate on those features or mutualize your costs with other people/companies. If you pay for these developments, we offer half a day of support for you and your team.

Note that each feature will be discussed and developed in the open with the whole community, financing bounties doesnt give you a stronger voice. If youre looking for personal/closed-source improvements we can do consulting too.

Versioning

Version numbering follows the Semantic versioning approach.

License

Were using the Apache 2.0 license for simplicity and flexibility. You are free to use it in your own project.

Credits

  • Roman Vasilenko - for creating tsMuxer