Coder Social home page Coder Social logo

transistor's Introduction

README

Transistor - Radio App for Android

Version 3.0.x ("Oh! You Pretty Things")

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, AAC and Ogg/Opus(*).

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 CONTRIBUTING.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 Play button ;).

How to stop playback?

Tap the Stop button within the app or on the notification - or just unplug your headphones.

How to start the sleep timer?

Tapping the Clock symbol in the stations detail screen 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 detail screen. 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/files/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 to 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.

(*) Opus playback is only supported on devices running Android 5.0+

Screenshots (v3.0)

transistor's People

Contributors

antonv6 avatar arnaudcoj avatar awandepan avatar azizsan avatar btimofeev avatar burunduk avatar comradekingu avatar franciscot avatar infozsoda avatar mbrksntrk avatar meonwax avatar mohammedbelkacem avatar naofum avatar nautilusx avatar nikoss avatar omaraglan avatar osoitz avatar pelya avatar weblate avatar woodypl avatar xpih avatar y20k avatar yfdyh000 avatar

Watchers

 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.