Metadata-Version: 2.1
Name: msrx
Version: 0.2
Summary: Library and command line utils to use MSR605 magnetic card reader/writer
Home-page: https://github.com/oxplot/msrx
Author: Mansour Behabadi
Author-email: mansour@oxplot.com
Maintainer: Mansour Behabadi
Maintainer-email: mansour@oxplot.com
License: GPLv3
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: End Users/Desktop
Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
Classifier: Natural Language :: English
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3.9
Classifier: Operating System :: POSIX :: Linux
Classifier: Topic :: Utilities
License-File: LICENSE.txt

Intro
=====

MSR605 is a very well built and popular magnetic card reader/writer.
msrx is a library and a command line utility that allows talking to this
device.

Features
========

 * msrx python module compatible with python 2.7+ and python 3
 * Command line utility with read, write and erase functionality

Installation
============

    $ pip install msrx

Usage
=====

To read a card's data, run the following and swipe a card:

    $ msrx read
    %PA1VSBUTT0 .8W11(BT003423342?|;943300000002342?:|

The output is a pipe ('|') separated track data in ISO-7811 format. In
the above example, only tracks 1 and 2 have data in them.

To erase a card, run the following and swipe a card (**WARNING** this is
non-reversible):

    $ msrx erase -t 1,3

The above erases tracks 1 and 3. To erase all tracks, leave out `-t`.

To write to a card, run the following and swipe a card:

    $ echo '%HAPPY?||;99?' | msrx write

This writes to tracks 1 and 3 because we left track 2 data empty. Note
that restrictions apply as to what set of characters and in what format
may be stored in each track. Consult ISO-7811 parts 2 and 6 for more
information.

To see other options, run msrx with `-h` option.

To use msrx as a library:

    import msrx
    mymsrx = msrx.MSRX('/dev/ttyUSB0')


