-
Notifications
You must be signed in to change notification settings - Fork 4
/
ReadMe.html
236 lines (224 loc) · 14.5 KB
/
ReadMe.html
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" lang="en-US" xml:lang="en-US">
<head>
<meta http-equiv="content-type" content="text/html; charset=utf-8" />
<meta http-equiv="Content-Style-Type" content="text/css" />
<meta name="robots" content="all" />
<title>UberTuber</title>
<style type="text/css">
body {
font-size: 0.9em;
font-family: "DejaVu Sans",Arial,Helvetica,sans-serif;
line-height: 1.5;
margin: 40px;
min-width: 45em;
max-width: 70em;
}
hr {
border: dotted thin #e0e0e0;
}
h1 {
font-size: 1.3em;
border-bottom: dotted thin #e0e0e0;
margin-bottom: 45px;
}
h2 {
font-size: 1.2em;
border-bottom: dotted thin #e0e0e0;
margin-top: 40px;
}
h3 {
font-size: 1em;
border-bottom: none;
margin-bottom: 0px;
}
tt {
background-color: #e2e2e2;
font-size: 1.0em;
font-family: monospace;
}
.key { /* Shortcut (separate with   */
-webkit-border-radius: 3px;
-khtml-border-radius: 3px;
-moz-border-radius: 3px;
border-radius: 3px;
border-color: #c7c7c7;
border-style: solid;
border-width: 1px;
padding: 0px 2px 0px 2px;
background-color: #e8e8e8;
font-family: sans;
font-variant: small-caps;
font-size: 1em;
}
.menu { /* Menu */
font-size: 1.0em;
font-family: serif;
font-style: italic;
color: #24225e;
}
</style>
</head>
<body>
<div align = "center">
<img width="64" height="64" src="./images/ubertuber_icon_64.png" alt="UberTuber icon" />
<p><span style="font-size: 1.5em; font-weight:bold">UberTuber</span><br />
for <a href="http://www.haiku-os.org">Haiku</a><br />
<i>by Humdinger</i></p>
<hr />
<p id="index"><a href="#settings">Settings</a> — <a href="#tips_tricks">Tips & Tricks</a> — <a href="#troubleshooting">Troubleshooting</a> — <a href="#download">Download</a> — <a href="#bug_feedback">Bugreports and Feedback</a> — <a href="#thanks">Thanks</a> — <a href="#history">History</a></p>
</div>
<hr />
<p><br /></p>
<p>UberTuber grabs clips from various sites and opens them in your media player while they're being downloaded. This is as close to streaming as it gets until Haiku's MediaKit grows real streaming support.</p>
<p>The actual work is done in the back-end, using the Python script <tt>youtube-dl</tt> which downloads the video file to your temporary folder. From there it is either played back while it gets downloaded or moved to another location you determine in a file dialog.</p>
<p>UberTuber monitors the system clipboard for URLs pointing to the supported websites and automatically inserts them into its URL text field. Now you just have to decide to either play or save the clip to start the download.</p>
<p>If the playback of a clip from a particular website works, depends on the underlying <tt>youtube-dl</tt> script, which gets updated from time to time. At this moment there is support for clips from:</p>
<div align="center"><p><i>YouTube, Google video, MetaCafe, DailyMotion, Yahoo video,<br />
Photobucket, DepositFiles, Vimeo.com, blip.tv, Facebook video,<br />
Escapist magazine, and many many more sites...</i></p>
<p>Youtube-dl's website has a list of <a href="http://rg3.github.io/youtube-dl/supportedsites.html">reportedly working sites</a>.
</p></div>
<h2>
<a href="#"><img src="images/up.png" style="border:none;float:right" alt="index" /></a>
<a id="settings" name="settings">Settings</a></h2>
<p>There are only very few user settings:</p>
<div align="center">
<img src="./images/ubertuber.jpg" alt="UberTuber window" />
</div>
<ul>
<li><p><b>Auto-play</b><br/>
This starts playback automatically, if a valid URL is detected in the clipboard. Convenient if you run UberTuber in the background while surfing the web: just copy the link to a clip in the browser and a few seconds later your media player starts playing it back.</p></li>
<li><p><b>Remove temporary files on quit</b><br />
The temporary folder is emptied when you shutdown Haiku. If you watch lots of long clips, disk space may become a concern. Check this option to have all temporary files deleted as soon as you quit UberTuber.</p></li>
<li><p><b>Edit monitored URLs...</b><br />
UberTuber monitors the system clipboard and automatically puts a URL it recognizes into its URL text box. With this menu item, you can change or add to this list of 'known' websites. It opens the settings file <tt>~/config/settings/UberTuber_monitored_sites</tt> in your text editor. Just put the distinguishing part of a site's URL in a new line and save the changes. UberTuber will immediately start recognizing the new address.</p></li>
</ul>
<h2>
<a href="#"><img src="images/up.png" style="border:none;float:right" alt="index" /></a>
<a id="tips_tricks" name="tips_tricks">Tips & Tricks</a></h2>
<ul>
<li><p><b>How can I play back embedded videos?</b><br />
In WebPositive, right-click on the black box of the embedded video and <span class="menu">Open frame in new window</span>. Now copy the URL and leave the rest to UberTuber's clipboard monitor.</p></li>
<li><p><b>Can I use bookmarks?</b><br />
UberTuber accepts a drag & dropped bookmark file (in fact any file with a META:url attribute). You can build up a library of video bookmarks while surfing with WebPositive, put them all in a folder and drag & drop one of them onto UberTuber.<br />
Or you can select all your video bookmarks and use Tracker's add-on <i>FileType</i> to set UberTuber as their preferred application. Then you can start those video bookmarks in UberTuber with a doubleclick.</p></li>
<li><p><b>What about starting from Terminal?</b><br />
When started from the Terminal, UberTuber accepts currently only one argument: either the path to a bookmark file or the URL to a clip.
</p></li>
</ul>
<h2>
<a href="#"><img src="images/up.png" style="border:none;float:right" alt="index" /></a>
<a id="troubleshooting" name="troubleshooting">Troubleshooting</a></h2>
<ul>
<li><p><b>Copied URLs won't automatically show up in UberTuber.</b><br />
The URL might fall through UberTuber's very simple test if it's from a supported site. You can add new URL-patterns or edit/remove existing patterns of that clipboard monitor, see the <i>Edit monitored websites...</i> menu item mentioned above.</p></li>
<li><p><b>UberTuber won't play/download clips from site X.</b><br />
Probably the website isn't supported by the <tt>youtube-dl</tt> script. Your only hope is that it has been added recently. Check the youtube-dl package for updates.</p></li>
<li><p><b>Sometimes I get a General OS error.</b><br />
This seems to be MediaPlayer's way to say that there hasn't been enough of the clip downloaded yet. It depends on the clip format and the speed of your internet connection. You can try closing the empty MediaPlayer window that pops up after the "General OS error" and press UberTuber's "Play" button once more.<br />
The alternative is to increase the buffering time a few seconds, but that would increase the time everyone has to wait for every clip... Email me, if it happens untolerably often to you and I may consider adding an option for the buffering.</p></li>
<li><p><b>Sometimes UberTuber just sits there, buffering or whatever.</b><br />
UberTuber is a bit of a hack as it tries to juggle the youtube-dl script and playback in MediaPlayer, while handling a possible aborting of these processes or saving the clip after playback has started. Add to that, that I'm a very unexperienced amateur "coder"... we're lucky it works at all most of the time.<br />
If things get out of control, you may find several stray threads of the scripts running in the background after UberTuber was quit. You can find and kill these threads with the ProcessController replicant of the Deskbar. Hint: the name of the threads contain "UberTuber" or "youtube-dl" etc. Yes, it's messy...</p></li>
</ul>
<h2>
<a href="#"><img src="images/up.png" style="border:none;float:right" alt="index" /></a>
<a id="download" name="download">Download</a></h2>
<p>UberTuber is directly available through HaikuDepot from the HaikuPorts repository. The source is hosted at <a href="https://github.com/humdingerb/ubertuber">GitHub</a>.</p>
<h2>
<a href="#"><img src="images/up.png" style="border:none;float:right" alt="index" /></a>
<a id="bugs_feedback" name="bugs_feedback">Bugreports and Feedback</a></h2>
<p>Please use GitHub's <a href="https://github.com/humdingerb/ubertuber/issues">issue tracker</a> if you experience unusual difficulties or email your general feedback to <a href="mailto:[email protected]">me</a>. Also, email me if you'd like to provide more localizations.</p>
<h2>
<a href="#"><img src="images/up.png" style="border:none;float:right" alt="index" /></a>
<a id="thanks" name="thanks">Thanks</a></h2>
<p>I have to thank Leszek Lesner for providing his MIT licensed code for <a href="http://www.zevenos.com/about/yavtd">YAVTD</a> which provided ideas and some lines of code for UberTuber.<br />
Also thanks to Duggan from the haiku-3rdparty IRC channel for hints and help to find crashing set-backs.<br />
Thanks to everyone that provided translations vor UberTuber.<br />
And finally thanks to the people providing the <a href="http://rg3.github.com/youtube-dl">youtube-dl</a> script.</p>
<p>If you kinda like UberTuber – or even more so if you don't – consider a <a href="http://www.haiku-inc.org/donations.html#online">donation to Haiku Inc.</a> or even better small monthly donations. This will accelerate Haiku development and may even help perfecting video playback into WebPositive, so UberTuber can eventually retire.</p>
<h2>
<a href="#"><img src="images/up.png" style="border:none;float:right" alt="index" /></a>
<a id="history" name="history">History</a></h2>
<p><b>0.9.0</b> - <i>24-09-2011:</i></p>
<ul>
<li>Initial release.</li>
</ul>
<p><b>0.9.1</b> - <i>30-09-2011:</i></p>
<ul>
<li>Forcing a MIME type video/mpeg4 when playing some clip. That way playback of some MP4 clips from sites like vimeo works, where before the media player complained it didn't know the format.<br />
After playback the system does a mimeset -F on the clip to set the correct MIME type or going back to the generic appliction/octet-stream.</li>
</ul>
<p><b>0.9.2</b> - <i>07-12-2011:</i></p>
<ul>
<li>The forcing of the MIME type to video/mpeg4 didn't always work. We now just set this MIME type with any file, not just octet-streams. We also buffer buffer 2 seconds longer for good measure.<br />
Aborting/killing the download should now work a bit better. Depending on length of the path to the UberTuber's installation folder, it didn't work at all before...</li>
</ul>
<p><b>0.9.3</b> - <i>17-11-2012:</i></p>
<ul>
<li>Added "youtu.be, blip.tv, escapistmagazine.com" to the clipboard monitor.</li>
<li>Fixed a bug that had "vimeo" URLs not auto-inserted from the clipboard.</li>
<li>Add META:url attribute with the download source URL also to the temporary file in /tmp/ubertuber.</li>
<li>Removed the need for youtube-dl.patch.</li>
<li>Truncate clip title if too long, don't resize the window anymore.</li>
<li>Fixed a small issue in the logic of the abort button.</li>
<li>Check if Python is installed and offer to install it if it's not.</li>
<li>Jump through another hoop to get thevideo title of newer versions of the youtube-dl script.</li>
</ul>
<p><b>0.9.4</b> - <i>24-11-2012:</i></p>
<ul>
<li>We now check at the start if Python is installed, instead when trying to download a clip.</li>
<li>Added the status "Installing Python" and "Installation finished" as feedback.</li>
<li>We should now correctly determine when MediaPlayer was closed.</li>
</ul>
<p><b>0.9.5</b> - <i>20-04-2013:</i></p>
<ul>
<li>Removed the need for git to update the youtube-dl script.</li>
<li>Added "youtube/embed" and "youtube-nocookie.com" to clipboard monitor. Now you can open embedded videos in a new tab from WebPositive's context menu and copy the URL from that new tab.</li>
<li>UberTuber is now hosted at http://sourceforge.net/p/ubertuber.</li>
</ul>
<p><b>0.9.6</b> - <i>14-10-2013:</i></p>
<ul>
<li>Removed the check for Python. Not needed anymore with Haiku's package management.</li>
<li>Adapted paths to new PM file system layout.</li>
<li>Better handling of filenames with special characters, e.g. /?:|<br />
Still not perfect, I guess, but better...</li>
</ul>
<p><b>0.9.7</b> - <i>20-10-2013:</i></p>
<ul>
<li>The special character business doesn't seem to always solvable. Therefore I just take the restricted ASCII filename from now on. Not as beautiful, but it seems to work much better. Also set --max-quality=22 of youtube-dl, which seems to get the highest quality mp4 instead of downloading a flv instead...</li>
</ul>
<p><b>0.9.8</b> - <i>21-12-2013:</i></p>
<ul>
<li>Removed youtube-dl from UberTuber package and declare that as dependancy.</li>
<li>Removed menu to update youtube-dl. It always was a security hole and now that the package managment is enforcing read-only locations for packages, it would take too many hoops to jump through to maintain this security nightmare...</li>
<li>Simplify code, making use of ps' new -o option. Simplify tests for running thread name.</li>
</ul>
<p><b>0.9.9</b> - <i>20-02-2014:</i></p>
<ul>
<li>Keep the GUI responsive while getting the clip title. The GUI used to be frozen in the first few seconds of downloading a clip.</li>
<li>Simplified code a bit by avoiding youtube-dl creating .part files</li>
<li>The clipboard monitored URLs are now stored in a node monitored settings file <tt>~/config/settings/UberTuber_monitored_sites</tt>.</li>
<li>Added a menu item to edit the UberTuber_monitored_sites settings file in the text editor.</li>
<li>Added a menu item to clear the text from the URL field.</li>
<li>Added a menu item to open the current URL in the browser.</li>
<li>Added a "Select this folder" button to the save panel.</li>
<li>Accept dropped bookmark files (or any file with a META:url attribute).</li>
<li>Register bookmark files as supported types of UberTuber, enabling opening "video" bookmarks of WebPositive with UberTuber.</li>
<li>Accept a URL or a bookmark as argument on the command line.</li>
</ul>
<p><b>0.9.10</b> - <i>24-02-2014:</i></p>
<ul>
<li>Always make sure /tmp/ubertuber exists or there may be race conditions.</li>
<li>Try to kill any zombi threads when aborting or exiting UberTuber.</li>
</ul>
<p><b>0.9.11</b> - <i>15-06-2014:</i></p>
<ul>
<li>Localizations for German, Polish.</li>
<li>Use "--format best" as youtube-dl's "--max-quality" is deprecated.</li>
</ul>
</body>
</html>