Debian packaging update

.gitignore

@@ -1,3 +1,7 @@
 *.DS_Store
 *.pyc
 *.pc
+dist
+build
+install
+*.egg-info

mkchromecast.py → bin/mkchromecast

@@ -1,6 +1,12 @@
-#!/usr/bin/env python
+#!/usr/bin/env python3
 
 # This file is part of mkchromecast.
+import os.path
+import sys
+
+HERE = os.path.dirname(__file__)
+if os.path.exists(os.path.join(HERE, '..', 'mkchromecast')):
+    sys.path.insert(0, os.path.join(HERE, '..'))
 
 import mkchromecast.__init__
 from mkchromecast.version import __version__
@@ -10,7 +16,6 @@
 from mkchromecast.pulseaudio import create_sink, remove_sink
 from mkchromecast.utils import terminate
 import subprocess
-import os.path
 import time
 import atexit
 import signal

mkchromecast.1

@@ -0,0 +1,52 @@
+.\"                                      Hey, EMACS: -*- nroff -*-
+.\" (C) Copyright 2017 Muammar El Khatib <muammar@debian.org>,
+.\"
+.\" First parameter, NAME, should be all caps
+.\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
+.\" other parameters are allowed: see man(7), man(1)
+.TH Mkchromecast "1" "December 23 2017"
+.\" Please adjust this date whenever revising the manpage.
+.\"
+.\" Some roff macros, for reference:
+.\" .nh        disable hyphenation
+.\" .hy        enable hyphenation
+.\" .ad l      left justify
+.\" .ad b      justify to both left and right margins
+.\" .nf        disable filling
+.\" .fi        enable filling
+.\" .br        insert line break
+.\" .sp <n>    insert n+1 empty lines
+.\" for manpage-specific macros, see man(7)
+.SH NAME
+mkchromecast \- cast audio and video to Google cast devices
+.SH SYNOPSIS
+.B mkchromecast
+.RI [ options ]
+.SH DESCRIPTION
+This manual page documents briefly the
+.B mkchromecast
+commands.
+.PP
+.\" TeX users may be more comfortable with the \fB<whatever>\fP and
+.\" \fI<whatever>\fP escape sequences to invode bold face and italics,
+.\" respectively.
+\fBmkchromecast\fP is a program that allows you to cast your audio or video
+files to your Google cast or Sonos devices.
+.SH OPTIONS
+This program follows the usual GNU command line syntax, with long
+options starting with two dashes (`-').
+A summary of options is included below.
+For a complete description, see the Info files.
+.TP
+.B \-h, \-\-help
+Show summary of options.
+.TP
+.B \-v, \-\-version
+Show version of program.
+.SH SEE ALSO
+.\".BR bar (1),
+.\".BR baz (1).
+.\".br
+The program is documented fully executing
+.IR "mkchromecast -h" ,
+that should give you complete access to the usage.

mkchromecast/__init__.py

@@ -33,7 +33,7 @@
     whereas, installation from source needs users to go inside the cloned git
     repository and execute:
 
-        python mkchromecast.py
+        mkchromecast
 
     The two examples above will make Mkchromecast streams with node.js (or
     parec in Linux) together with mp3 audio coding format at a sample rate of
@@ -57,7 +57,7 @@
     ALSA in your system.
 
     Example:
-        python mkchromecast.py --encoder-backend ffmpeg --alsa-device hw:2,1
+        mkchromecast --encoder-backend ffmpeg --alsa-device hw:2,1
 
     It only works for the ffmpeg and avconv backends, and it is not useful for
     pulseaudio users. For more information read the README.Debian file shipped
@@ -77,10 +77,10 @@
     Example:
 
     ffmpeg:
-        python mkchromecast.py --encoder-backend ffmpeg -c ogg -b 128
+        mkchromecast --encoder-backend ffmpeg -c ogg -b 128
 
     node:
-        python mkchromecast.py  -b 128
+        mkchromecast  -b 128
 
     This option works with all backends. The example above sets the average
     bitrate to 128k.
@@ -101,10 +101,10 @@
     Example:
 
     ffmpeg:
-        python mkchromecast.py --encoder-backend ffmpeg -c ogg -b 128 --chunk-size 2048
+        mkchromecast --encoder-backend ffmpeg -c ogg -b 128 --chunk-size 2048
 
     avconv:
-        python mkchromecast.py --encoder-backend avconv -c ogg -b 128 --chunk-size 64
+        mkchromecast --encoder-backend avconv -c ogg -b 128 --chunk-size 64
 
     '''
     )
@@ -118,7 +118,7 @@
     Set the audio codec.
 
     Example:
-        python mkchromecast.py --encoder-backend ffmpeg -c ogg
+        mkchromecast --encoder-backend ffmpeg -c ogg
 
     Possible codecs:
         - mp3  [192k]   MPEG Audio Layer III (default)
@@ -139,7 +139,7 @@
     Set a ffmpeg or avconv command for streaming video.
 
     Example:
-        python3 mkchromecast.py --video --command 'ffmpeg -re -i \
+        mkchromecast --video --command 'ffmpeg -re -i \
         /path/to/myvideo.mp4 -map_chapters -1 -vcodec libx264 -preset ultrafast \
         -tune zerolatency -maxrate 10000k -bufsize 20000k -pix_fmt yuv420p -g \
         60 -f mp4 -max_muxing_queue_size 9999 -movflags \
@@ -204,7 +204,7 @@
         - gstreamer
 
     Example:
-        python mkchromecast.py --encoder-backend ffmpeg
+        mkchromecast --encoder-backend ffmpeg
     '''
     )
 
@@ -218,7 +218,7 @@
     one network device available.
 
     Example:
-        python mkchromecast.py --encoder-backend ffmpeg --host 192.168.1.1
+        mkchromecast --encoder-backend ffmpeg --host 192.168.1.1
 
     You can pass it to all available backends.
     '''
@@ -233,7 +233,7 @@
     Stream a file.
 
     Example:
-        python mkchromecast.py -i /path/to/file.mp4
+        mkchromecast -i /path/to/file.mp4
     '''
     )
 
@@ -247,7 +247,7 @@
     connect.
 
     Example:
-        python mkchromecast.py -n mychromecast
+        mkchromecast -n mychromecast
     '''
     )
 
@@ -270,7 +270,7 @@
     Example:
 
     ffmpeg:
-        python mkchromecast.py --encoder-backend ffmpeg -p 5100
+        mkchromecast --encoder-backend ffmpeg -p 5100
 
     '''
     )
@@ -343,10 +343,10 @@
     Example:
 
     ffmpeg:
-        python mkchromecast.py --encoder-backend ffmpeg -c ogg -b 128 --sample-rate 32000
+        mkchromecast --encoder-backend ffmpeg -c ogg -b 128 --sample-rate 32000
 
     node:
-        python mkchromecast.py -b 128 --sample-rate 32000
+        mkchromecast -b 128 --sample-rate 32000
 
     This option works for both backends. The example above sets the sample rate
     to 32000Hz, and the bitrate to 128k.
@@ -380,7 +380,7 @@
 
     Examples:
 
-        python mkchromecast.py --video --screencast
+        mkchromecast --video --screencast
     '''
     )
 
@@ -393,7 +393,7 @@
     HH:MM:SS.
 
     Example:
-        python mkchromecast.py --video -i "/path/to/file.mp4" --seek 00:23:00
+        mkchromecast --video -i "/path/to/file.mp4" --seek 00:23:00
 
     '''
     )
@@ -406,7 +406,7 @@
     Segmentate audio for improved live streaming when using ffmpeg.
 
     Example:
-        python mkchromecast.py --encoder-backend ffmpeg --segment-time 2
+        mkchromecast --encoder-backend ffmpeg --segment-time 2
 
     '''
     )
@@ -422,13 +422,13 @@
     Example:
 
     Source URL, port and extension:
-        python mkchromecast.py --source-url http://192.99.131.205:8000/pvfm1.ogg -c ogg --control
+        mkchromecast --source-url http://192.99.131.205:8000/pvfm1.ogg -c ogg --control
 
     Source URL, no port, and extension:
-        python mkchromecast.py --source-url http://example.com/name.ogg -c ogg --control
+        mkchromecast --source-url http://example.com/name.ogg -c ogg --control
 
     Source URL without extension:
-        python mkchromecast.py --source-url http://example.com/name -c aac --control
+        mkchromecast --source-url http://example.com/name -c aac --control
 
     Supported source URLs are:
 
@@ -477,7 +477,7 @@
     Update Mkchromecast git repository.
 
     Example:
-        python mkchromecast.py --update
+        mkchromecast --update
 
     This will execute for you:
 
@@ -505,13 +505,13 @@
     Examples:
 
     Cast a file:
-        python mkchromecast.py --video -i "/path/to/file.mp4"
+        mkchromecast --video -i "/path/to/file.mp4"
 
     Cast from source-url:
-        python mkchromecast.py --source-url http://commondatastorage.googleapis.com/gtv-videos-bucket/sample/BigBuckBunny.mp4 -c mp4 --control --video
+        mkchromecast --source-url http://commondatastorage.googleapis.com/gtv-videos-bucket/sample/BigBuckBunny.mp4 -c mp4 --control --video
 
     Cast a youtube-url:
-        python mkchromecast.py -y https://www.youtube.com/watch\?v\=VuMBaAZn3II --video
+        mkchromecast -y https://www.youtube.com/watch\?v\=VuMBaAZn3II --video
 
     '''
     )
@@ -539,7 +539,7 @@
         http://rg3.github.io/youtube-dl/supportedsites.html.
 
     Example:
-        python mkchromecast.py -y https://www.youtube.com/watch?v=NVvAJhZVBTc
+        mkchromecast -y https://www.youtube.com/watch?v=NVvAJhZVBTc
 
     Note that this is only working for websites running over https.
         '''