MMM-Parcel

martinkooij

Description

Hi all,

I just wanted to glance over my mirror and track incoming parcels, as me and my family start to be rather heavy users of Internet buying. Well heavy… but still a few parcels per week. I thought it would be nice to show the overall status on the mirror.

The MMM-AfterShip module by @Mykle1 wich used the aftership interface inspired me to reuse that interface for parcel trackings but I needed a more compact display. So I changed the output design to a visual design with less details and more visual color and icon cues for shipment status.

Alas the Dutch PostNL nor DHL provide free API’s to receiving users, but both couriers (and +400 more) are available via Aftership. ’

The Mirror module shows the parcels that you enter via your aftership account. Aftership offers a free account with free API use when you stay under 100 parcels per month via their website aftership.com.

Screenshots

There are three presentations modes ranging from moderately compact (max three lines per parcel) to compact (max two lines per parcel) to very compact (one-liner per parcel), which can be set in config. Just as languages and colors.

Examples:

alt text

Download

[card:martinkooij/MMM-Parcel]

martinkooij

Now with autoTranslate feature! And today (2018-03-24) some minor improvements for usability. Have fun and track all deliveries to your home.

modderhut

Thanks, I really like the look of this one!

One problem for me, even the very compact “2” view is too big for my mirror.

Is there a way to have the icon and the header on one line and the status and forwarder on the next line? Or set a column width and use wrap?

thanks
Modderhut

martinkooij

yes, would be possible, I think. Good idea,!

I’ll look into a compact “3”. If we exchange mailadresses can you send me a picture of your mirror, so I can understand a little bit better what you mean… Because compactness 2 should already show a 1 liner…

cheers, martin

goprojojo

Great module! Are the names of the packages customizable too?

martinkooij

@goprojojo Thanks! But also thanks to Aftership.com for providing the API.

The parcel names (titles in aftership-speak) are customizable via the aftership app, or via the aftership.com website (login -> trackings). Just select the shipment, click edit and enter your own title in the title field. This name will then appear on the mirror-screen. Let me know if that helps and answers your question.

martinkooij

@modderhut . Thanks for your comment and compliments! For now you can set maxWidth: "350px" in the module config parameters or whatever pixwidth works for you. Sorry, this was an undocumented feature ;).

Your feedback also prompted me to consider the behavior of the module in a “narrow” space. I will soon release a functional enhancement for this module in order to autoadapt the module display to a narrow(er) space, maintaining effectiveness and the “look and feel”.

twosquirrels

This is a great module, but whenever I change the compactness to anything other than 1, it fails to load. I really want 2 for “very compact”, but it just displays this:

alt text

martinkooij

@twosquirrels Thank you for liking the module, and this clearly seems a bug that I haven’t seen yet, and can’t reproduce at home here. Sorry. I have dropped you a PM with my contact info, if you would be willing to help me debugging your situation.

twosquirrels

@martinkooij

This wound up being due to my own impatience. I did get “undefined” after restarting magic mirror, but if I waited a few minutes, it would appear in the desired format. Perhaps the API call wasn’t being performed yet. I was just tinkering too much to wait. Thanks again for making this module!

martinkooij

To the users: thanks for your compliments. Your comments inspire me to add new functionality. Today (2018-03-30): a layout that caters for narrow spaces on the mirror and the possibility to automatically hide delivered packages after a configurable number of days. Have fun and keep on commenting!

twosquirrels

Great! But… I seem to have messed up the update, perhaps because I tried to update from the /config folder:

pi@magicmirror:~/MagicMirror/config $ git pull https://github.com/martinkooij/MMM-Parcel.git
warning: no common commits
remote: Counting objects: 241, done.
remote: Compressing objects: 100% (23/23), done.
remote: Total 241 (delta 11), reused 14 (delta 4), pack-reused 214
Receiving objects: 100% (241/241), 682.03 KiB | 0 bytes/s, done.
Resolving deltas: 100% (119/119), done.
From https://github.com/martinkooij/MMM-Parcel
 * branch            HEAD       -> FETCH_HEAD
fatal: refusing to merge unrelated histories

pi@magicmirror:~/MagicMirror/modules/MMM-Parcel $ git pull
Updating a4093aa..31ec835
Fast-forward
 MMM-Parcel.js  | 160 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++-------------------------------------------------
 README.md      | 135 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++-------------------------------------------
 node_helper.js |  10 +++++----
 package.json   |   2 +-
 4 files changed, 199 insertions(+), 108 deletions(-)

It’s stuck at “Loading Parcel module…” How do I remove MMM-Parcel so that I can put it back correctly?

martinkooij

@twosquirrels Basically the most radical way is to remove everything MMM-Parcel from both …/config and from …/modules and make a clean install with clone. I sent you a PM, let me know if it works for you.

twosquirrels

@martinkooij

I installed the update and used the new module code. It worked, although the “hideDelivered” doesn’t seem to be working. I have it set for “3” and as of April 5, I still have a March 28 delivery showing as delivered.

  hideDelivered: 3, // Hide delivered parcels after 15 days.

martinkooij

@twosquirrels Hi. I am sorry it doesn’t work for you. I must have missed a date format from aftership I think, because on my parcels upto now it works like a charm. If you can help me debug, can you please send me (via my personal mail, I sent you a PM) the console output after putting debug: true in the module config. This spits out a lot of info into the console output / log files.

Mike111111

This site is not bad for tracking parcels. The site can be viewed at https://parceltrackingapp.com/en.

luisestrada

@martinkooij said in MMM-Parcel:

onsole outpu

did you guys come up with a solution? I get that “Loading Parcel Module” and even when I delete and redo anything, it doesn’t work

JohnBachini

@luisestrada

it works for me. But sure for how much longer as had email from them saying they are making some changes to there API. So that may well break it.

bhepler

@JohnBachini - As a developer, you can probably ask them for a preview of their upcoming API changes. They may be running it on a test server somewhere that you can hit and work out the necessary modifications to your code.

luisestrada

This is my error message

[ERROR]  TypeError: aftershipSDK is not a constructor
    at Class.fetchShipments (/home/pi/MagicMirror/modules/MMM-Parcel/node_helper.js:91:22)
    at Class.startUpdateNext (/home/pi/MagicMirror/modules/MMM-Parcel/node_helper.js:126:8)
    at Class.socketNotificationReceived (/home/pi/MagicMirror/modules/MMM-Parcel/node_helper.js:116:9)
    at Socket.<anonymous> (/home/pi/MagicMirror/js/node_helper.js:113:11)
    at Socket.emit (events.js:200:13)
    at /home/pi/MagicMirror/node_modules/socket.io/lib/socket.js:528:12
    at processTicksAndRejections (internal/process/task_queues.js:82:9)