Giter Club home page Giter Club logo

transistor's Introduction

README

Transistor - Radio app for Android

Version 2.0.x ("Starman")

Transistor is a bare bones app for listening to radio programs over the internet. The app stores stations as files on your device's external storage. It currently understands streams encoded in MP3 and OGG.

Important note: This is an app of type BYOS ("bring your own station"). It does not feature any kind of built-in search option. You will have to manually add radio stations.

Transistor is free software. It is published under the MIT open source license. Want to help? Please check out the notes in CONTRIBUTE.md first.

Install Transistor

... or get a Release APK here on GitHub

How to use Transistor

How to add a new radio station?

The easiest way to add a new station is to search for streaming links and then choose Transistor as a your default handler for those file types. You can also tap the (+) symbol in the top bar and paste in streaming links directly. Please note: Transistor does not feature any kind of built-in search option.

How to play back a radio station?

Tap the big Play button ;).

How to stop playback?

Tap the big Stop button or unplug your headphones or swipe off the notification from the lock screen.

How to start the sleep timer?

Tapping the Clock symbol starts a 15 minute countdown after which Transistor stops playback. An additional tap adds 15 minutes to the clock. Playback must be running to be able to activate the sleep timer.

How to place a station shortcut on the Home screen?

The option to place a shortcut for a station on the Home screen can be accessed from the station's three dots menu. A tap on a shortcut will open Transistor - playback will start immediately.

How to rename or delete a station?

The rename and delete options can be accessed both from the station's context menu. Just tap on the three dots symbol. You can manage the list of stations also from a file browser (see next question).

Where does Transistor store its stations?

Transistor does not save its list of stations in a database. Instead it stores stations as m3u files on your device's external storage. Feel free to tinker with those files using the text editor of your choice. The files are stored in /Android/data/org.y20k.transistor/Collection.

How do I backup and transfer my radio stations?

Transistor supports Android 6's Auto Backup feature. Radio stations are always backed up to your Google account and will be restored at reinstall. On devices running on older versions of Android you must manually save and restore the "Collection" folder.

Why does Transistor not have any setting?

There is nothing to be set ;). Transistor is a very simple app. Depending on your point of view "simple" is either great or lame.

Which Permissions does Transistor need?

Permission "INSTALL_SHORTCUT" and "UNINSTALL_SHORTCUT"

This permission is needed to install and uninstall radio station shortcuts on the Android Home screen.

Permission "INTERNET"

Transistor streams radio stations over the internet.

Permission "READ_EXTERNAL_STORAGE"

Transistor needs access to images, photos and documents to be able customize radio station icons and to able to open locally saved playlist files.

Permission "VIBRATE"

Tapping and holding a radio station will toggle a tiny vibration.

Permission "WAKE_LOCK"

During Playback Transistor acquires a so called partial wake lock. That prevents the Android system to stop playback for power saving reasons.

transistor's People

Contributors

y20k avatar weblate avatar btimofeev avatar naofum avatar burunduk avatar franciscot avatar meonwax avatar osoitz avatar yfdyh000 avatar pelya avatar awandepan avatar arnaudcoj avatar infozsoda avatar

Watchers

James Cloos avatar Udo Kifferbrehl avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.