SageTV Community  

Go Back   SageTV Community > SageTV Development and Customizations > SageTV Customizations

Notices

SageTV Customizations This forums is for discussing and sharing user-created modifications for the SageTV application created by using the SageTV Studio or through the use of external plugins. Use this forum to discuss customizations for SageTV version 6 and earlier, or for the SageTV3 UI.

Reply
 
Thread Tools Search this Thread Display Modes
  #1  
Old 04-14-2010, 09:56 AM
stuckless's Avatar
stuckless stuckless is offline
SageTVaholic
 
Join Date: Oct 2007
Location: London, Ontario, Canada
Posts: 9,540
Users / Add-ons / Problems / SageTV [rant]

Ok... it's not a rant... but, but I wanted to post something here, that is a more a "call to users" than a "call for developers".

I added some functions to SageTV in areas that I've felt it was deficient (ie, remote apis (sagex-apis), bmt (metadata tools), phoenix apis (fanart, etc)).

At this point, I spend about 20+hrs a week on SageTV related projects, and I do it for 2 reasons.
1. I want to make SageTV better for my own personal use
2. Some of what I do can be of value to others (consider it 'charity' for Geeks)

In addition to myself, there are numerous other developers that have added functionality to SageTV, such as the Jetty Web Server (jreichen), SJQ (Slugger), SageMC (MeInMaui), and the list goes on... In fact If I were try and name every current active developer, then I'd probably be here for hours

One of the things that comes up from time to time is how complex it is to get something "simple" working, or the lack of "documentation" for a given plugin (or series of interconnected plugins, bmt, sagemc, tvexplorer, etc). Personally I find this hard to believe, since I install my stuff, from scratch, about 5-10 times a week. I've provided a wiki page on sagex and bmt which I thought was quite well done, and really showed how simple the whole thing is. But, maybe, myself (and perhaps developers in general), aren't the best person/people to write documentation for their plugins, since we tend to gloss over steps that we find trivial (and to be honest, most of this stuff is trivial to us, because spend our lives in things like this... it'll be like asking your to write a help document on the windows start menu)

So, here's my challenge to the users... You spend your time fighting with a series of add-ons... you ask good questions... you get answers (hopefully), and finally at some point, it all works (hopefully)... you are happy... end of story. But why not just take a little extra time, and help the developer by writing a guide for a particular add-on.

You don't even have to tackle the whole add-on, just taking a part of it, would be helpful. For example if I look at BMT... here's a quick list of what some guides could look like...

Installing BMT
Upgrading BMT
UPgrading Phoenix for BMT
Configuring the Automatic Plugin
Troubleshooting why the Automatic isn't working
Naming your files for better matches
Forcing Matches using the MediaTitles
How to Exclude directories
Understanding Regular Expressions and how they are used in BMT
Installing the WebUI
Troubleshooting the WebUI
Configuring BMT for use with DVDProfiler

and the list goes on.... No one person needs to tackle all topics (and the list is by no means exhaustive), but maybe if a couple of people took ownership of some of the topics, then over time, we'd have a collection of documents/guides that could be beneficial to others.

Many people have asked how they can help... well, here's a chance.... and Some people already have... in BMT 3.x I received document submissions from a couple of people, and I was thankful for it. I know Brent has done some really great guides on SageMC and certain features of SageMC (and no expects you to be as good as those )

So, that's my rant (not really a rant), but rather a call for help, from end users, to help make the add-ons that you love, that much better.

Good luck.
Sean.
Reply With Quote
  #2  
Old 04-14-2010, 10:02 AM
PLUCKYHD PLUCKYHD is offline
SageTVaholic
 
Join Date: Dec 2007
Posts: 6,257
Here Here!!!

ps I appreciate the charity for geeks very much

pss- I have to say I have never written documentation very much but Brent and Dbone have always been willing if I ask them.

Last edited by PLUCKYHD; 04-14-2010 at 10:22 AM.
Reply With Quote
  #3  
Old 04-14-2010, 10:05 AM
jaminben jaminben is offline
Sage Icon
 
Join Date: Sep 2007
Location: Norwich, UK
Posts: 1,754
Send a message via MSN to jaminben
Yea, I think thats a really nice idea..... perhaps if dev's were to start a wiki page upon release of their work and then leave it for user's to update over time.

Cheers

Ben
__________________
Server - Win7 64bit, 2.4Ghz Intel Core 2 Duo, TBS 6284 PCI-E Quad DVB-T2 Tuner, 3 x HD200 & 1 x HD300 extenders
Reply With Quote
  #4  
Old 04-14-2010, 10:40 AM
SWKerr SWKerr is offline
Sage Icon
 
Join Date: Jun 2008
Posts: 1,178
That is a great idea and I think you could get people to help with this if there was a good place to post and maintain such a repository. This is where I think Sage needs to step in a provide a WIKI framework for the documentation. A Plug-ins Wiki would be great for users. This would be a good place to highlight the most used plug-ins and maintain documentation.

I have on occasion created some step by step guides but on the forum it will eventually get buried in all the support posts.

I think this is something that needs to be supported by SageTV the company in order to survive long term. I think a Sage Plug-ins Wikipedia managed by the Sage community and Developers would work. Forums and Wikis serve two different purposes and Sage needs both. The Forum format does not work well for documentation and general communications.

Some developers have done a great job and created there own but they really need to be centralized and advertised by Sage to work well for basic users. I think it is also fair that the users share in the work the developers put into their plug-ins by helping with the documentation.

Last edited by SWKerr; 04-14-2010 at 10:46 AM.
Reply With Quote
  #5  
Old 04-14-2010, 10:47 AM
vividweb vividweb is offline
Sage Aficionado
 
Join Date: Aug 2006
Location: Calgary AB
Posts: 399
Quote:
Originally Posted by SWKerr View Post
I think a Sage Plug-ins Wikipedia managed by the Sage community and Developers would work.
Very good idea. A common location for wikis would be helpful.
__________________

Sage Server: i5-2500K 8 GB DDR, 6000gb HDD, 4xHD-PVR < 4xBell 6141, Win7 x64
Client 1: HD-200, Panasonic 42PX75
Client 2: HD-300, Samsung LCD
Client 3: HD-300, Samsung PN50C550
Client 4: MS Surface Pro
Reply With Quote
  #6  
Old 04-14-2010, 11:15 AM
wrems's Avatar
wrems wrems is offline
Sage Icon
 
Join Date: Feb 2007
Location: Marietta, GA
Posts: 1,332
I think that's a great idea too!

Even though I'm not a developer, I can understand how it could be frustrating repeating yourself for the mundane details. I agree, some sort of wiki framework would be ideal.

To all the developers: THANK YOU FOR WHAT YOU DO!! Sage wouldn't be the same without all of your efforts. I just hope that I can contribute in some meaningful way.
Reply With Quote
  #7  
Old 04-14-2010, 11:22 AM
stuckless's Avatar
stuckless stuckless is offline
SageTVaholic
 
Join Date: Oct 2007
Location: London, Ontario, Canada
Posts: 9,540
I think that something that could potentially work as well as a WIKI (most projects have a wiki of some sort) is to just use the forum. ie, if you write a Guide on how to configure BMT to do something specific, then start a new thread and document it there. Then you can PM the developer (me in this case), and I can create a section in the first post for Guides and HowTos and I can link from there to your Thread. Or, you can use google docs, and PM me the link... or you can add a Wiki page to the BMT project (as an example) but I'd have to give you documentation access to the project for that to happen.

If you use the forum, then others can comment on the guide, and you own the first post, so you can continue to update and maintain it.
Reply With Quote
  #8  
Old 04-14-2010, 11:40 AM
Brent Brent is offline
SageTVaholic
 
Join Date: May 2006
Location: KC, Missouri
Posts: 3,695
I've intended to help more in the documentation area, but life (work & home stuff) keeps pulling me away lately - you may have noticed a much less frequent posting schedule at GeekTonic lately due to the same reason. I have begun a good document on BMT for dummies (I'm in the dummy category btw) as well as several others I've delved into. But yes, any help others can contribute in the way of documentation would be great.

I think a wiki is always a great idea, but if anyone has something they'd like to throw at me, I can also put it on GeekTonic for the masses. I'm in the process of updating the "Ultimate guide to SageTV" landing page on GeekTonic for release sometime around the release of the fabled SageTV 7 whenever that might be....

PS - I really, really, really appreciate the hard work, countless hours, thick skin (dealing with sometimes cranky HTPC enthusiasts) and expertise of the many awesome developers for SageTV. It wouldn't be nearly as much fun without you!

Last edited by Brent; 04-14-2010 at 11:48 AM.
Reply With Quote
  #9  
Old 04-14-2010, 12:18 PM
Skirge01's Avatar
Skirge01 Skirge01 is offline
SageTVaholic
 
Join Date: Jun 2007
Location: New Jersey
Posts: 2,599
I think this is a great post. When I was having issues getting jreichen's Jetty Webserver up and running, I took to documenting the steps and posting them and they wound up on the Wiki once it was cleaned up. It wasn't all that difficult and it was nice to be able to give back to him and the community.

Quite a few people seem to ask "how can I thank you?" and this sounds like a great method for just that!
__________________
Server: XP, SuperMicro X9SAE-V, i7 3770T, Thermalright Archon SB-E, 32GB Corsair DDR3, 2 x IBM M1015, Corsair HX1000W PSU, CoolerMaster CM Storm Stryker case
Storage: 2 x Addonics 5-in-3 3.5" bays, 1 x Addonics 4-in-1 2.5" bay, 24TB
Client: Windows 7 64-bit, Foxconn G9657MA-8EKRS2H, Core2Duo E6600, Zalman CNPS7500, 2GB Corsair, 320GB, HIS ATI 4650, Antec Fusion
Tuners: 2 x HD-PVR (HTTP tuning), 2 x HDHR, USB-UIRT
Software: SageTV 7
Reply With Quote
  #10  
Old 04-14-2010, 03:22 PM
OneOfMany OneOfMany is offline
Sage Aficionado
 
Join Date: Apr 2009
Location: Winnipeg
Posts: 374
I agree 120% with this. I am considered a "geek" and computers are my business. Although I don't post a lot, I have spent numerous hours searching the forums, reading linked wikis, finding scattered instructions in multi-page postings all in the need to figure out what I'm doing, how I am to do it, and how I am to troubleshoot it.

The Sage plug-in page is a disaster in my opinion, and does little to help users to understand and deploy the plug-ins. As a result, you great developers spend way too much time answering questions and accepting log files in order to solve problems when you could be developing (or enjoying a well-deserved beer )

I actually started writing down the steps I used to install and deploy everything, however I ended up going backwards and forwards so many times, it became useless.

I certainly am willing to contribute, however simply starting another thread is not going to cut it.

Setup a proper sub-page on the main Sage page, and let's do it!

Grant
Reply With Quote
  #11  
Old 04-14-2010, 09:55 PM
mayamaniac's Avatar
mayamaniac mayamaniac is offline
Sage Icon
 
Join Date: May 2004
Posts: 2,177
Quote:
Originally Posted by stuckless View Post
In addition to myself, there are numerous other developers that have added functionality to SageTV, such as the Jetty Web Server (jreichen), SJQ (Slugger), SageMC (MeInMaui), and the list goes on... In fact If I were try and name every current active developer, then I'd probably be here for hours
Even in your short list, you can't leave out (Web server) neilm!

By the way, I installed BMT a while back and don't even remember doing it. And it continued to do its thing, scanning and updating all the videos with meta data. It's a powerful tool and it just works flawlessly. We don't say thanks enough for the great plugins and addons from the developers of this community.

This is a great idea. I would go beyond documentations and suggest Opus4 to open a tutorial section sub-forum. Following tutorials is much easier than reading the manual. And even better than that is video screen capture of the tutorials.
__________________
Mayamaniac

- SageTV 7.1.9 Server. Win7 32bit in VMWare Fusion. HDHR (FiOS Coax). HDHR Prime 3 Tuners (FiOS Cable Card). Gemstone theme.
- SageTV HD300 - HDMI 1080p Samsung 75" LED.
Reply With Quote
  #12  
Old 04-15-2010, 05:33 AM
stuckless's Avatar
stuckless stuckless is offline
SageTVaholic
 
Join Date: Oct 2007
Location: London, Ontario, Canada
Posts: 9,540
Quote:
Originally Posted by mayamaniac View Post
Even in your short list, you can't leave out (Web server) neilm!
You are absolutely right. Sorry Neilm The web server plugin is the one of the few plugins that I use... but I do run it under Jetty, which I why it slipped my mind, for the short list
Reply With Quote
  #13  
Old 04-15-2010, 07:12 AM
pjpjpjpj pjpjpjpj is offline
Sage Icon
 
Join Date: Feb 2008
Posts: 2,068
Great idea, and I'd again like to take this chance to say THANKS!!!! to all the great developers who make Sage a better product for all of us!

I'd certainly be willing to add comments and tips to any wiki-type pages, if I had info that was useful. I probably wouldn't have much (I don't use some of the more-popular plug-ins and I don't use a lot of the more-common Sage hardware setups)... but I'm a pretty good writer.
__________________
Server: AMD Athlon II x4 635 2.9GHz, 8 Gb RAM, Win 8.1 x64, Java 8, Gigabit network
Drives: Several TB of internal SATA and external USB drives, no NAS or RAID or such...
Software: SageTV v9, stock STV with ADM.
Tuners: 4 tuners via (2) HDHomeruns (100% OTA, DIY antennas in the attic).
Clients: Several HD300s, HD200s, even an old HD100, all on wired LAN. Latest firmware for each.
Reply With Quote
  #14  
Old 04-15-2010, 09:32 AM
JetreL's Avatar
JetreL JetreL is offline
Sage Aficionado
 
Join Date: Jun 2008
Location: Charlotte, NC
Posts: 388
I am always willing to help where I can with documenting some of the Plug-ins. That's one of the biggest complaints that I originally had with SageTV, steep learning curve and limited documentation of the plugins. I have never enjoyed programing. (More of a systems person myself) Maybe this is a way that I can give back to the community. If anyone needs any help with that PM me and I will see what I can come up with.

Have we PM'd anyone from Sage about starting an official Wiki?
Reply With Quote
  #15  
Old 04-15-2010, 10:26 AM
sic0048 sic0048 is offline
Sage Icon
 
Join Date: Nov 2007
Posts: 1,255
This was my exact reasoning for creating the "How To" install the HD-PVR I did. Not because I am some expert or know it all, but because I struggled getting it to work and wanted to share a method that seemed to work very well.

I'm actually pretty "dumb" when it comes to technology. I'm not a programmer, a network admin, IT guy, etc at all and have no training in any of these areas. So I need a really dumbed down set of instructions many times to get things working.

I'd love to see more write ups because it would help me personally. For example, I wasn't willing to try Comskip until Brent wrote his excellent "How To" in his blog. Now it is one of my favorite features.
__________________
i5 quad core server with about 10tb of space currently
SageTV v9 (32bit)
Ceton InfiniTV ETH 6 cable card tuner (Charter cable)
OpenDCT
HD-100 HD Extenders
HD-300 HD Extenders
Nvidia Shield using the MiniClient
Using CQC to control it all
Reply With Quote
  #16  
Old 04-17-2010, 07:36 AM
KarylFStein KarylFStein is offline
Sage Fanatic
 
Join Date: Apr 2006
Location: Westland, Michigan, USA
Posts: 999
Would there be interest in starting a community-driven site based on something like FusionForge? Not to replace the SageTV forums or places that other people already use like Google, Assembla, and SourceForge, but a place that lists all the available plug-ins, has project pages for developers that *they* (and/or people they trust) manage, (Wiki, announcement lists, forums, files, etc. or links to whatever system they currently use), and a place for general Wikis? I'm not a fan of adding "yet another site" especially given the wealth of data already on these forums--it's just an idea I had on how to spread admin work around and address the "on-127-page-thread-to-rule-them-all" issue...
__________________
Home Network: https://karylstein.com/technology.html
Reply With Quote
  #17  
Old 04-20-2010, 08:04 AM
dkopp dkopp is offline
Sage User
 
Join Date: Jan 2010
Posts: 13
I previously submitted this on some post. I will look for a host platform and report back.


"I appreciate all the efforts of everyone. I am not a programmer but a pretty goog geek.

I have been thinking about creating a roadmap to the ideal media center. It would include BMT, TVExplorer, etc. So far these are my favorite plugins.

So.....I offer my help in merging the best of the best "
Reply With Quote
  #18  
Old 04-21-2010, 06:52 AM
ChaOConnor's Avatar
ChaOConnor ChaOConnor is offline
Sage Aficionado
 
Join Date: Nov 2008
Location: Bel Air, MD
Posts: 355
I am all about this, and will help organize it. Doing some searching, I found an already existing, but not used Wikia setup at: http://sagetv.wikia.com/wiki/SageTV_...re_PC_Software I'm trying to contact the owner and see if we can use it. I'd be more than happy to incorporate their content, but make it a broader site.

Steps I see needing to be done:
1. Find a suitable hosting site, easily accessible by everyone, easy to use and edit.
2. Collect content already out there. Many developers have already started their own install instructions, etc. Start with those and then comb through threads to pull out an extra tips, etc.
2a. We'd need a divide and conquer type approach. Each person willing to help would need to sign up for a particular piece and work it till it's 90% completion. Then we'd move on to another topic.

Many more steps, but this is where it starts.

Any suggestions on point #1?
__________________
Server: AMD Phenom II X6 1090T 3.2GHz, ASRock 890FX Deluxe4 890FX, PNY Optima 8GB DDR3 1333
Media Storage: Rosewill RSV-S4-X 4 Bay Enclosure w/ 4 x 3TB via unRAID
Capture: HDHomerun Prime, HDHomerun x 2
Software: Sage Server 7.1.9 on Windows 7 (Virtualized in ESXi)
Clients: i3-2105, ASRock Z68 Pro3-M, 4GB DDR3 1600, 64GB SATA III (OS), 2TB WD Green (Recording), PNY GT 430 // 2 x HD-300
Reply With Quote
  #19  
Old 04-21-2010, 07:07 AM
dkopp dkopp is offline
Sage User
 
Join Date: Jan 2010
Posts: 13
I host my own server, not an expert at all. I have been fooling around with Joomla. I think it could be an answer. I am willing to host a site. Look into Joomla.org, and see if the group feels it could work.

In the meantime I will install a joomla site and post a link.
Reply With Quote
  #20  
Old 04-22-2010, 03:37 PM
jreichen's Avatar
jreichen jreichen is offline
Sage Icon
 
Join Date: Jul 2004
Posts: 1,192
This is a great idea.

For those who are interested in contributing, I think any of us developers would be more than happy to provide you with any information you might need for your contributions - that shouldn't keep anyone from getting involved.

There are plenty of opportunities, too: creating installation and configuration steps (thanks Skirge01!), enhancing and organizing existing content, documenting common errors and resolutions, and setting up and running the web site to name a few. I also think we need more articles about *what* the plugins are used for and "case studies" of how users are setting up their systems - anything to help the newbies get up and running.

I also think it's worthwhile to look into Joomla and Drupal for publishing and organizing the content.
__________________
Server: Intel Core i5 760 Quad, Gigabyte GA-H57M-USB3, 4GB RAM, Gigabyte GeForce 210, 120GB SSD (OS), 1TB SATA, HD HomeRun.
Extender: STP-HD300, Harmony 550 Remote,
Netgear MCA1001 Ethernet over Coax.
SageTV: SageTV Server 7.1.8 on Ubuntu Linux 11.04, SageTV Placeshifter for Mac 6.6.2, SageTV Client 7.0.15 for Windows, Linux Placeshifter 7.1.8 on Server and Client
, Java 1.6.
Plugins: Jetty, Nielm's Web Server, Mobile Web Interface.

Reply With Quote
Reply


Currently Active Users Viewing This Thread: 1 (0 members and 1 guests)
 
Thread Tools Search this Thread
Search this Thread:

Advanced Search
Display Modes

Posting Rules
You may not post new threads
You may not post replies
You may not post attachments
You may not edit your posts

BB code is On
Smilies are On
[IMG] code is On
HTML code is Off

Forum Jump

Similar Threads
Thread Thread Starter Forum Replies Last Post
SageMC, STVis, and Add Ons: Dependencies, Hoop Jumping, and Confusion [rant] ptzink SageMC Custom Interface 24 04-14-2010 09:14 AM
Add ons......Why so difficult Kryspy SageMC Custom Interface 18 09-24-2009 11:13 AM
Any Digital Transition Problems for SageTV users w/ OTA Brent SageTV EPG Service 7 03-19-2009 03:21 PM
Best add-ons or changes for default sagetv install... t4uecker SageTV Customizations 5 03-05-2008 05:48 PM
Add-ons, plug-ins, and MVP ToonGal SageTV Customizations 0 09-21-2005 02:15 AM


All times are GMT -6. The time now is 09:57 PM.


Powered by vBulletin® Version 3.8.7
Copyright ©2000 - 2019, vBulletin Solutions, Inc.
Copyright 2003-2005 SageTV, LLC. All rights reserved.