Maemo Wiki Mirror - User contributions [en]

DialCentral

2011-01-25T21:45:06Z

130.164.70.22: adding mention of log file

DialCentral (formerly called GC Dialer) is meant as an interface to Google's GoogleVoice service that integrates with your Maemo device or Linux computer.

== Screenshots ==

[[Image:DialCentral_Account.png|frame|center|alt=Screenshot of DialCentral account view|'''Note:''' Be sure to set your callback number before making calls]]

[[Image:DialCentral_Dialpad.png|frame|center|alt=Screenshot of DialCentral showing ‘dialpad’ view|Dialpad view]]

[[Image:DialCentral_History.png|frame|center|alt=Screenshot of DialCentral showing ‘history’ view|Note that a call was placed relatively recently since it is under the refresh time. There is nothing else during the day the history was refreshed. Several items in the previous week.]]

[[Image:DialCentral_Messages.png|frame|center|alt=Screenshot of DialCentral showing ‘messages’ view|Note that a text was sent relatively recently since it is under the refresh time. There is nothing else during the day the history was refreshed. Several items in the previous week.]]

[[Image:DialCentral_Contacts.png|frame|center|alt=Screenshot of DialCentral showing ‘contacts’ view|Contacts with dividers]]

[[Image:DialCentral_Call.png|frame|center|alt=Screenshot of DialCentral showing ‘call’ view|Start a call or enter a text for a contact]]

[[Image:DialCentral_SMS.png|frame|center|alt=Screenshot of DialCentral showing ‘SMS’ view|Texting someone from the history]]

[[Image:DialCentral_BroadcastSMS.png|frame|center|alt=Screenshot of DialCentral showing ‘group SMS’ view|Sending a group SMS]]

== Features ==

Basic features:
* Dialpad for click-to-call (callback, forwarding, whatever you want to call it)
* Sending of SMS including group SMS
* Recent calls list
* Voicemail/SMS viewer
* Contact list, either from GV website or CSV

Keyboard Shortcuts
* Ctrl+Enter - toggle between fullscreen
* Ctrl+w, Ctrl+q - quit
* Ctrl+l - Copy the debug log contents
* Ctrl+i to import a CSV

CSV Support
* Must be imported (or placed in "~/.dialcentral/contacts")
* Displayed in the addressbook selector based on the filename
* Supported columns with the following in their names "name", "phone", "mobile"
* Known to work with GoogleVoice and GrandCentral exports.

== Getting DialCentral ==

Getting DialCentral
* Maemo 4.1: Available in [[extras]] through the Application Manager.
* [http://maemo.org/downloads/product/Maemo5/dialcentral/ Maemo 5] or available in extras through the Application Manager.
* [http://gc-dialer.garage.maemo.org/dialcentral.deb Ubuntu]

DialCentral has been tested on:
* Ubuntu 10.04
* Maemo 4.1
* Maemo 5

== Contribute ==

* [https://bugs.maemo.org/enter_bug.cgi?product=Dialcentral File a bug]
* [https://bugs.maemo.org/buglist.cgi?query_format=specific&order=relevance+desc&bug_status=__open__&product=Dialcentral&content= View existing bug reports]
* [http://talk.maemo.org/showthread.php?p=293533 talk.maemo.org thread]
* [https://garage.maemo.org/projects/gc-dialer/ Garage Project (including code)]
* Learn about [[extras-testing]] and checkout the [http://maemo.org/packages/view/dialcentral/ Package page (including voting)]

DialCentral is available under the [http://www.gnu.org/licenses/gpl-2.1.html GPL v2.1 license]

Icons are licensed [http://creativecommons.org/licenses/by-nc-nd/3.0/ "The Creative Commons Attribution-NonCommercial -- FREE"] from
http://www.gentleface.com/free_icon_set.html

=== Troubleshooting and Reporting of Bugs ===

Are the Call/SMS buttons grayed out?
* This means it is not logged in

Can't call
* In the account configuration, is a callback number set?
* Did you enter the area code?
* Have you tried calling a good known number like one of your own (that isn't the callback)

The views show stale data?
* Go into the menu and select "Refresh"

Information to include when reporting an issue
* Your version of Dialcentral
* Information from the steps you followed above
* From what tab are you having issues (Dialpad, Recent, Messages, Account Info)?
* Is it a US or international number?
* (For the advanced) Could you post the contents of "~/.dialcentral/dialcentral.log"

For serious users and serious problems (Google changes the "API") is the following command:
<source lang="bash">/opt/dialcentral/lib/backends/gvoice/gvoice.py USERNAME PASSWORD</source>
Note that this writes a bunch of files ''with sensitive information'' to the current working directory. Please gather those up, scrub them if desired, and send them to me directly to avoid ''sensitive information'' from being leaked out.

==== Notifications ====

Really if you want this, maybe you should be using The One Ring.

If notifications are acting odd, try experimenting with these
<source lang="bash">
python /opt/dialcentral/lib/alarm_handler.py -x # Show alarm
python /opt/dialcentral/lib/alarm_handler.py -d # Delete the alarm
python /opt/dialcentral/lib/led_handler.py # Stop the LED
</source>

In settings.ini
<source lang="ini">
[alarm]
notifier=PATH_TO_CUSTOM_NOTIFIER
</source>

Example notifiers included:
<source lang="bash">
/opt/dialcentral/lib/alarm_notify.py #Default
/opt/dialcentral/lib/examples/log_notifier.py
/opt/dialcentral/lib/examples/sound_notifier.py
</source>

The program that periodically checks for new messages has its own log file: ~/.dialcentral/notifier.log

[[Category:Software]]
[[Category:Diablo]]
[[Category:Fremantle]]

DialCentral

2011-01-25T16:27:56Z

130.164.70.22: Adding a bit about notifications

DialCentral (formerly called GC Dialer) is meant as an interface to Google's GoogleVoice service that integrates with your Maemo device or Linux computer.

== Screenshots ==

[[Image:DialCentral_Account.png|frame|center|alt=Screenshot of DialCentral account view|'''Note:''' Be sure to set your callback number before making calls]]

[[Image:DialCentral_Dialpad.png|frame|center|alt=Screenshot of DialCentral showing ‘dialpad’ view|Dialpad view]]

[[Image:DialCentral_History.png|frame|center|alt=Screenshot of DialCentral showing ‘history’ view|Note that a call was placed relatively recently since it is under the refresh time. There is nothing else during the day the history was refreshed. Several items in the previous week.]]

[[Image:DialCentral_Messages.png|frame|center|alt=Screenshot of DialCentral showing ‘messages’ view|Note that a text was sent relatively recently since it is under the refresh time. There is nothing else during the day the history was refreshed. Several items in the previous week.]]

[[Image:DialCentral_Contacts.png|frame|center|alt=Screenshot of DialCentral showing ‘contacts’ view|Contacts with dividers]]

[[Image:DialCentral_Call.png|frame|center|alt=Screenshot of DialCentral showing ‘call’ view|Start a call or enter a text for a contact]]

[[Image:DialCentral_SMS.png|frame|center|alt=Screenshot of DialCentral showing ‘SMS’ view|Texting someone from the history]]

[[Image:DialCentral_BroadcastSMS.png|frame|center|alt=Screenshot of DialCentral showing ‘group SMS’ view|Sending a group SMS]]

== Features ==

Basic features:
* Dialpad for click-to-call (callback, forwarding, whatever you want to call it)
* Sending of SMS including group SMS
* Recent calls list
* Voicemail/SMS viewer
* Contact list, either from GV website or CSV

Keyboard Shortcuts
* Ctrl+Enter - toggle between fullscreen
* Ctrl+w, Ctrl+q - quit
* Ctrl+l - Copy the debug log contents
* Ctrl+i to import a CSV

CSV Support
* Must be imported (or placed in "~/.dialcentral/contacts")
* Displayed in the addressbook selector based on the filename
* Supported columns with the following in their names "name", "phone", "mobile"
* Known to work with GoogleVoice and GrandCentral exports.

== Getting DialCentral ==

Getting DialCentral
* Maemo 4.1: Available in [[extras]] through the Application Manager.
* [http://maemo.org/downloads/product/Maemo5/dialcentral/ Maemo 5] or available in extras through the Application Manager.
* [http://gc-dialer.garage.maemo.org/dialcentral.deb Ubuntu]

DialCentral has been tested on:
* Ubuntu 10.04
* Maemo 4.1
* Maemo 5

== Contribute ==

* [https://bugs.maemo.org/enter_bug.cgi?product=Dialcentral File a bug]
* [https://bugs.maemo.org/buglist.cgi?query_format=specific&order=relevance+desc&bug_status=__open__&product=Dialcentral&content= View existing bug reports]
* [http://talk.maemo.org/showthread.php?p=293533 talk.maemo.org thread]
* [https://garage.maemo.org/projects/gc-dialer/ Garage Project (including code)]
* Learn about [[extras-testing]] and checkout the [http://maemo.org/packages/view/dialcentral/ Package page (including voting)]

DialCentral is available under the [http://www.gnu.org/licenses/gpl-2.1.html GPL v2.1 license]

Icons are licensed [http://creativecommons.org/licenses/by-nc-nd/3.0/ "The Creative Commons Attribution-NonCommercial -- FREE"] from
http://www.gentleface.com/free_icon_set.html

=== Troubleshooting and Reporting of Bugs ===

Are the Call/SMS buttons grayed out?
* This means it is not logged in

Can't call
* In the account configuration, is a callback number set?
* Did you enter the area code?
* Have you tried calling a good known number like one of your own (that isn't the callback)

The views show stale data?
* Go into the menu and select "Refresh"

Information to include when reporting an issue
* Your version of Dialcentral
* Information from the steps you followed above
* From what tab are you having issues (Dialpad, Recent, Messages, Account Info)?
* Is it a US or international number?
* (For the advanced) Could you post the contents of "~/.dialcentral/dialcentral.log"

For serious users and serious problems (Google changes the "API") is the following command:
<source lang="bash">/opt/dialcentral/lib/backends/gvoice/gvoice.py USERNAME PASSWORD</source>
Note that this writes a bunch of files ''with sensitive information'' to the current working directory. Please gather those up, scrub them if desired, and send them to me directly to avoid ''sensitive information'' from being leaked out.

==== Notifications ====

Really if you want this, maybe you should be using The One Ring.

If notifications are acting odd, try experimenting with these
<source lang="bash">
python /opt/dialcentral/lib/alarm_handler.py -x # Show alarm
python /opt/dialcentral/lib/alarm_handler.py -d # Delete the alarm
python /opt/dialcentral/lib/led_handler.py # Stop the LED
</source>

In settings.ini
<source lang="ini">
[alarm]
notifier=PATH_TO_CUSTOM_NOTIFIER
</source>

Example notifiers included:
<source lang="bash">
/opt/dialcentral/lib/alarm_notify.py #Default
/opt/dialcentral/lib/examples/log_notifier.py
/opt/dialcentral/lib/examples/sound_notifier.py
</source>

[[Category:Software]]
[[Category:Diablo]]
[[Category:Fremantle]]