emailCellUsage 1.2 ReadMe
Change List for 1.32
Fixed AT&T support after AT&T web site changes
Fixed Verizon support after Verizon web site changes
Dropped Sprint support after authentication changes
Sprint has changed how they authenticate and after spending a bit of time
trying to get it squared away I am giving up for now. If anyone would like
to take a go at it, the code is still in the source reposatory. If you are using this
functionality and would like me to fix, drop me a line. If I know someone is using
this, it would help provide motivation.
Change List for 1.31
Added support for shared data plans on AT&T. Note, AT&T no longer provides text and voice summaries on these plans.
Change List for 1.30
Fixed issues with ATT plugin that manifested itself only after a recent data plan change
Change List for 1.29
Fixed issues with ATT plugin after more site changes by AT&T
Change List for 1.28
Fixed issues with ATT plugin after site changes by AT&T
I do not explictly support shared data plans, or at least that has not been tested in any way.
I do not have an account set up for that for testing as of yet. If you need this functionality
please reach out and maybe we can help eachother out.
Change List for 1.27
Fixed issues with Sprint plugin
Change List for 1.26
Fixed issues with Verizon plugin due to site change
Change List for 1.25
Fixed AT&T plugin to fix issue with Upgrade dialog screen blocking access
Fixed AT&T issue that caused issues when new accounts were created
Fixed scheduling issue
Add OSX digital signature for Mountain Lion compatability
Change List for 1.24
Fixed AT&T plugin to fix issue with individual accounts
Change List for 1.23
Fixed AT&T plugin after AT&T site change
Change List for 1.22
Fixed Verizon plugin after Verizon site change
Change List for 1.21
Fixed AT&T plugin after AT&T site change
Fixed bug in Sprint plugin
Change List for 1.2
I am declaring the software release ready!!
That being said, the carrier plugins can be fragile based on changes in
the providers web site, variations in individual account setups, and
many other factors. If the software is missing data that should be
present, or does not function as desired PLEASE file a bug via sourceforge
and work with me to resolve the issue. I may ask you to save the HTML on
certain URL's on your cell providers web site, or work with me in other
ways to resolve the issue without compromising your web site password.
If you don't reachout to me and work with me, I can not fix issues. I also
can't have 2 or three accounts per carrier to represent various configurations.
I am a single developer, carrier issues can only be resolved with the help of
people encountering issues, and working with me to resolve. Thanks
Change List for 1.2b4
Improved error handling
Fixed broken Verizon plugin cause by Verizon web site change
Change List for 1.2b3
Updated icons for Windows and OSX
Added in app icon for windows, replacing the Tk icon
Change List for 1.2b2
Revert OSX back to using cron, had issues with making launchd reliable
Change List for 1.2b1
Added Plugin Support
Fixed bugs
Changes list for 1.1b5
Add windows service to bring windows up to par for emails going out when app is not launched
Internal cleanups
Changes list for 1.1b4
Added Sprint compatibility
Fixed AT&T compatability after they did a site re-design
Fixed windows email sending during the PM hours
Added account sorting to All Phone Numnbers report
Found a better fix for the OSX Lion screen to front issue, a pop up window no longer appears at launch
Add update notifcations in email and at application launch
Added better button visual to indicate the next step at launch
Mac OSX version more Mac like.
Using launchd instead of cron
Moved preference files to ~/Libraries/Application Support/emailCellUsage/ directory
emailCellUsage is being distributed as OpenSource via the GPL2 license.
I have coded this app to be functional and to work as advertised, that being
said, use at your own risk. I personally guarentee that nothing malicious will
be done with any crednetials you provide this code as written by me, the sole
developer of this tool to date. That being said plugins, third party changes,
third party tools reading my preference files, or malicious modifications by
others can occure and I can not be held liable for any harm under any
circumstances, again use at your own risk. This is free software.
https://sourceforge.net/projects/emailcellusage/
Full documentation can be found here
https://sourceforge.net/p/emailcellusage/wiki/Documentation/
What is emailCellUsage
This application is designed to help you manage your cell phone usage and
avoid overage charges. It will send you a daily email report of your cell phone
usage.
* Supports multiple phone numbers associated with the same account
* Supports multiple accounts from AT&T,Sprint, or Verizon, and potentially others via Plugins
* Offers flexibility in when and how often these email reports go out
* Shows the usage, the estimate monthly usage, and the limit in the email report
* Shows color coding in email, yellow or red if estimates show potential issues
The estimated usage is based on an assume 30 days billing cycle and just takes the
number of days you have usage and extrapolates that across the entire billing cycle.
To get AT&T, Verizon, or Sprint data usage the tool logs into your account via the
public web site for your provider using your provided credentials. No data is stored
anywhere but on your machine. Your credentials will be stored on your machine, in your
home directory, readable only by you. Credentials are not stored in plain text, but
they are not strongly encrypted either.
Since neither AT&T, Verizon, nor Sprint offer any API or 'blessed' way to programmatically
access their sites, this code could easily be broken by them making changes to their site
UI or authentication methods. Since this tool uses there public web site to pull down your
data, future compatibility with these sites is not guaranteed by myself, AT&T, Sprint,
Verizon, or anyone else.
This project is not endorsed or affiliated with AT&T,Sprint, nor Verizon in any way.
The current tool uses cron to schedule the notification job on Linux, and Mac.
For Windows users a service is installed and runs that handles the email going out. Your machine
still has to be awake at the scheduled time though.
The tool is written in Python/Tkinter and is available as the python source as well
as a compiled Mac, and Windows.
Installing a Plugin
WARNING!!!! Plugin code is provided with your cell phone web site credentials. There is no
way around this without major support from the cell phone companies, and I am not holding
my breath for that to happen. The ATT, Sprint, and Verizon plugins distributed with the
default package were written by myself and the data is ONLY used to authenticate with the
cell provider web site and retrieve your data. Plugins not written by me, but posted to
http://sourceforge.net/emailcellusage have been reviewed by me and should be considered safe.
That being said, I can not be held liable for any harm that may come from using code written
by others, or even written by myself.
To use a plugin, quit the application and place the plugin file in the following directory
Compiled OSX, the plugin must also be compiled for OSX
{right click and select 'Show Package Content'}
emailCellUsage.app/Contents/MacOS/communicationPlugins/
Compiled Windows, the plugin must also be compiled for Windows
/Program Files/emailCellUsage/communicationPlugins/
Native Python
emailCellusage/lib/communciationPlugins
When you relauch emailCellUsage you should now see that cell provider listed as available when
you create or modify an account
Ron Dorn
