Index: CREDITS ================================================================== --- CREDITS +++ CREDITS @@ -16,11 +16,14 @@ → Major fix/patch for Live365 · Heinrich Schwietering, http://ubuntuusers.de/ → external + user-friendly documentation -· Jean-Yves Lefort and contributors, +· https://fiverr.com/graphicshome + → The new application logo/banner + +· Jean-Yves Lefort (and contributors), → For the original STREAMTUNER 0.99.xx! Of course also many thanks to all users reporting and helping to investigate bugs! @@ -31,9 +34,14 @@ · Daniel, http://www.librepc.com/ · Troy · darose · b.nikola · stefantalpalaru - · micha @ musicgoal + · micha, musicgoal · jay.l.h And probably many others... + +Lastly, a big thanks to all distro package +maintainers. It's not the just tools which +make BSD/Linux vibrant, but the relentless +effort from you guys & gals! Index: PACKAGERS ================================================================== --- PACKAGERS +++ PACKAGERS @@ -7,10 +7,11 @@ ---------------------------------------- → There's a new `bin` script. It's a lightweight invocation wrapper, intended to be installed as /usr/bin/streamtuner2 now. + Which hopefully avoids lengthy patches in the future. → The previous `st2.py` still exists, but is now supposed to reside in `/usr/share/streamtuner2/st2.py` along with all other modules. @@ -20,13 +21,21 @@ I'd still advise to use /usr/share/streamtuner2/ as main target directory though. It's not yet practical to extract into Python site-package directories. The channel PNG files still need to reside alongside the Python -modules. Later versions may complete soak the images into the +modules. Later versions may completely soak the images into the source code (meta data section) for simpicity. + +Renames +------- + + · bookmarks, configdialog, streamedit were extracted into + channels/ - which is why the main module got lighter. + · uikit.py is the new mygtk + Aux files --------- → Help files still need to go to share/docs/streamtuner2/help/ @@ -38,14 +47,16 @@ Removed ------- -Some plugin PNGs may have been removed already. +Some plugin PNGs may have been removed already. (Embedded +binary data may violate some distro guidelines(?), but hey, +fewer files are fewer files.) -And the streamtuner2.png logo is now source-embedded instead -(`logo.py` provides a `logo.png`). +And the streamtuner2.png logo is now source-embedded instead, +the`logo.py` module provides a `logo.png` string. The old `gtk2.xml` file is gone. It probably became obsolete a long while back. The gtk3.xml is instead runtime-patched to work with PyGTK/gtk2. @@ -58,13 +69,13 @@ and only APT could so anyway. But if feasible... Also, hard dependencies are meanwhile: - gtk (>= 2.16) - - pygtk || python-gi + - pygtk [or python-gi for python3] - python-requests (>> 1.2.0) - - python-pyquery [though most plugins would work without] + - python-pyquery [though most plugins would work without] - and its implied python-lxml Optional dependencies (just affects a single plugin, which semi-gracefully disables itself): @@ -75,16 +86,16 @@ - python-xdg Strongly suggest: - - Streamripper + - streamripper [or ficy/fpls etc.] + - any audio player of course Suggest: - - any audio player of course - - youtube-dl + - youtube-dl [technically not required, as VLC works without] Lazy installation ----------------- Index: README ================================================================== --- README +++ README @@ -1,23 +1,26 @@ streamtuner2 ============ -ST2 is a internet radio browser. It queries online directories like -shoutcast and xiph.org for music stations. +ST2 is a browser for internet radio/streaming stations. It queries +directories like Shoutcast, TuneIn, MyOggRadio, Xiph.org. SurfMusic, +Jamendo etc. for music/video streams/collections. -It mimics the original streamtuner 1 to some extend. It's however -written in Python now instead of C. +It mimics the original streamtuner 1 to some extend. +It's however written in Python now instead of C. Installation howto ------------------ If possible, prefer the package directly from your BSD/Linux distribution. -Due to an excessive maintenance break, some still have older 2.0.8 version -however - which barely works anymore. -If so, you should use a manually installed version. + +Due to a longer maintenance and release break, some still have older 2.0.x +versions however - whose channel plugins barely work anymore. If so, you +should install a newer version / manually. + Dependencies ------------ Running streamtuner2 requires Python and Gtk packages. Which nowadays are @@ -36,10 +39,11 @@ sudo apt-get install python python-gtk2 python-xdg python-requests ... Or utilize Pythons local package installer even: sudo pip install requests + sudo pip install pyquery DEB / RPM --------- @@ -90,19 +94,46 @@ Moreover you can also edit the user interface. You need glade-3 installed, and open the "gtk3.xml" file. There it's easy to rename or rearrange things. + +Sources +------- + +You'll find the current source files under +http://fossil.include-once.org/streamtuner2/ + +That's a fossil DVCS repository. Which is miles easier to use than +git. You can download the single binary from http://fossil-scm.org/ +or from your distro, then check out the repo: + + fossil clone http://fossil.include-once.org/streamtuner2/ st2.fossil + fossil open st2.fossil + +Or browse the contents + + fossil ui + +Alternatively there are git and svn exports. + + fossil export --svn + http://fossil.include-once.org/streamtuner2/git-fast-export + +You can send in patches, a fossil bundle, or set up your cloned +repo publically `fossil cgi`. Else just create an account on +fossil.include-once.org, and send a mail, so I can elevate that +account to developer/commit/push permissions quickly. (Fossil +repos don't break. So dealing out sync access is a no-brainer.) + alternatives ------------ -* http://sourceforge.net/projects/radiotray/ -* https://sites.google.com/site/glrpgreatlittleradioplayer/ -* http://tunapie.sourceforge.net/ -* VLC also has a few directory discovery services built-in -* Rythmbox comes with last.fm, libre.fm, radio lookups +See http://fossil.include-once.org/streamtuner2/wiki/alternatives +for a list of recommended alternatives. Future ST2 versions will +try to interface and share more with them. license -------