Skip to main content

May the LINE be with you...

Project description

|PyPi version| |PyPi downloads|

  • 2014.08.06 UPDATE : Echo bot example update!!!

  • 2014.08.06 UPDATE : We can send a sticker!!!

  • 2014.08.04 ANNOUNCE : This project is not completed yet :(

May the LINE be with you…

>>> from line import LineClient
>>> client = LineClient("carpedm20", "xxxxxxxxxx")
Enter PinCode '9779' to your mobile phone in 2 minutes
>>> client = LineClient("", "xxxxxxxxxx")
Enter PinCode '7390' to your mobile phone in 2 minutes
>>> print client.profile


First, you need to install Apache Thrift. Install instructions are here. (This might take some time…)


$ pip install line

Or, you can use:

$ easy_install line

Or, you can also install manually:

$ git clone git://
$ cd LINE
$ python install


First, you need to create a LineClinet object with YOUR_ID and YOUR_PASSWORD. YOUR ID can be LINE email address or NAVER id.

>>> from line import LineClient
>>> client = LineClient(YOUR_ID, YOUR_PASSWORD)
Enter PinCode '9779' to your mobile phone in 2 minutes

After you enter PinCode to your mobile phone, you will get authToken.

>>> authToken = client.authToken
>>> print authToken

With authToken, you don’t have to enter PinCode to your phone anymore!

>>> client = LineClient(authToken=authToken)
>>> print client.profile

View contacts and groups

You can see your contacts by:

>>> print client.contacts  # your friends
>>> print client.groups

Get contact and group from name

You can get contact and group from name by:

>>> contact = client.getContactFromName('CONTACT_NAME')
>>> group = client.getGroupFromName('GROUP_NAME')

Send a message

You can send a message by:

>>> client.contacts[0].sendMessage("test")
>>> client.groups[0].sendMessage("test")

Send a sticker

You can send a sticker by:

>>> client.contacts[0].sendSticker() # default option
>>> client.groups[0].sendSticker() # default option
>>> client.contacts[0].sendSticker(stickerId="1",stickerPackageId="1",stickerVersion="100")
>>> client.groups[0].sendSticker(stickerId="1",stickerPackageId="1",stickerVersion="100")

Get a list of recent message

You can read a recent message from contact or gruop by:

>>> messages = client.contacts[0].getRecentMessages(count=10)
>>> messages = client.groups[0].getRecentMessages(count=1)

Refresh contacts and groups

If there is any change of contacts. you need to update contacts by:

>>> client.refreshContacts()
>>> client.refreshGroups()




  • Get chat room list (currently only can get group and contact)

  • Long poll feature

  • Send a Image file

  • Make a echo bot example… (this is my major goal right now)

  • More usable methods and objects


Source codes are distributed under BSD license.


Taehoon Kim / @carpedm20

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

line-0.0.8.tar.gz (9.9 kB view hashes)

Uploaded source

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page