You are here: Home › Mileage-Matey › Mileage Matey


Mileage Matey is an easy to use motoring expenses recording and calculating application. The primary design objective was to create an app that would be quick and simple to operate in order to make the mileage recording process as fast and painless as possible. To that end there are very few screens to navigate through, for the most part, everything you need access to is present on the screen you first see upon launching the app with only less frequently used operations such as emailing reports and backups kept in a submenu.

Mileage Matey works by recording distances between pairs of locations. In the simplest of cases, a contractor may wish to record the distance between his home and the location of the client he is currently working for. The distance between the locations is entered manually. Although GPS could be used to calculate the distance, this brings to light more issues than it resolves;
  • GPS consumes a lot of power and will very quickly run down the battery in your device.
  • The time to get an accurate GPS lock varies and can be quite significant, generally much longer than the time taken to manually pick a location and enter an odometer reading.
  • GPS is only available on 3G enabled iOS devices.

Once a journey has been recorded between two locations, Mileage Matey remembers the distance between them and will automatically fill in that value for future journeys between these locations, the locations are also remembered so you only ever need to enter them once and subsequent journeys between those locations simply require you to pick those locations from a list and all other details will be filled in automatically.

Recording Your First Journey

Upon first launching Mileage Matey you will see a screen like this;

Press the button marked "+" in the bottom right of the screen. This takes you to the Journey Details screen.

Press "Please Set Start" and you will see a list of previously recorded locations, initially this will be empty. Press the "+" button in the bottom left corner to enter a new location, type the name of the location and hit "save". You can add as many locations as you like and you can delete unused locations by pressing the "edit" button in the top right and selecting which locations to delete. Once you have entered your start location, select it from the list and you will return to the Journey Details screen. Repeat the process for the destination by pressing "Please set end".

Once you have entered a start and end, press the "Distance" button and you will see the distance entry screen which looks like this;

Enter the distance either by rotating the wheels or typing it in. The left wheel represents distance in miles or kilometres (depending on the current settings) and the right wheel represents tenths of a mile/km. If you wish to type the distance using the number pad, you can only enter whole miles/km, however you can adjust the entered value using the 1/10th wheel if you like. Once the correct value is set press back to return to the Journey details screen.

The date and time will have automatically been filled in with the current date and time, but you can adjust this by pressing it and using the date picker.

The distance you have entered should be for the journey from start to end. However, if it was a roundtrip between the two points, you can indicate this by pressing "With Return". A little tick will appear to the right and the fact that the distance has been doubled will be indicated with a "2x" indicator on the distance button.

The final essential detail is the Rate per mile. Pressing this will present you with a similar screen to the distance screen. In the case the left wheel represents your currency (£,$ etc) and the right wheel represents 1/100ths of this currency (pennies, cents and so on). Again, you can simply type the value on the keypad. Once you have set the rate, press back to return to the previous screen. Which will now display the total value of the journey using the details you've entered.

Finally, although, not essential, you can record the name of the client you visited and add notes for your own reference. The buttons for these are lower down the screen so you will need to scroll up to access them.

Once you are happy with all of the details entered, press Save to record the journey and return to the main screen which should now look something like this;

You've logged your first journey and all of its important details are shown in the list. If you wish to make changes you can by pressing on the entry in the list and you can delete a journey by pressing the edit button at the top right and selecting which journeys to delete.

When you next add a journey, it will automatically pre-fill with the information from the previously logged journey (but use the current date and time), this is useful when repeatedly visiting the same location.

When editing start and end locations, if the pair of locations have previously been used together, Mileage Matey will fill in the distance using the last recorded distance for this pair of locations.

Using The History View

The main screen in Mileage Matey is known as the History View. This shows a chronological list of all recorded journeys starting with the most recent at the top. By default, it shows journeys for the current month as can be seen here;

The time period displayed is shown on the button in the bottom left of the screen, the length of the period can be changed by pressing it. Each press will cycle through the available options, which are;

  • Calendar Month
  • Calendar Year - 1st January to 31st December
  • Fiscal Year - 1st April to 31st March
  • All - your complete recorded history

At the top of the screen is displayed the total value of the journeys and the total distance for the selected period.

You can adjust the currently displayed period shown by pressing the -/+ button. Each press will select the next or previous month or year depending on the current configuration. These buttons have no effect if "All" is selected.

Exports and Backups

Mileage Matey can generate reports in CSV format that can be loaded straight into a spreadsheet application for analysis. To generate a report, select the time period you are interested in, press the "Options" button and press "Email CSV for Selected Period". A preformatted email will be created containing the report as an attachment. Simply fill in the recipient, make any adjustments you require and hit send. The reports contain the following information for every recorded journey;

  • Date
  • Start location (from)
  • End location (to)
  • Client name
  • Total Distance of the journey including return if set (in the currently selected units - miles or km)
  • Rate per mile
  • Total value

You can also send a backup of the entire database by pressing "Options" then pressing "Email Backup". This can be used to recover all of your data in case your device is damaged or lost or the app gets uninstalled or corrupted for some reason. To reload the data, simply open the email on the device and open the attachment, choose Mileage Matey from the options given and the database will be loaded into Mileage Matey. Note that any existing data will be lost if you do this.

Miscellaneous Features and Settings

Mileage Matey will automatically adjust to display dates and currency using the locale settings of your device, however, distances specified by the device settings do not necessarily represent the users preferences, for example the UK typically uses miles for motoring related distances, yet the iOS locale settings would suggest using metric units such as kilometres. To work around this issue, you can manually set your preferred distance units to either miles or kilometres. By default, it will be set to miles, but you can override this by selecting "Options" and pressing "Display distances as km".

If you require technical support, discover bugs or have any suggestions or comments about Mileage Matey, you can email us directly from the app by going to Options and selecting Contact Developer.