docs: updated README

main^2
Daniel 2023-08-21 21:27:00 +02:00 committed by GitHub
parent c0e402540e
commit 1b1392ca7a
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 178 additions and 81 deletions

259
README.md
View File

@ -1,96 +1,193 @@
# Flipper-IRDB <img src="https://github.com/fork-2/Flipper-IRDB/assets/71837281/04949e4f-3a39-4f6a-9524-634b5412ba9c" width="100%" />
A **maintained** collective of different IR files for the Flipper! We'd love to have your additions! [See here.](https://github.com/UberGuidoZ/Flipper-IRDB/blob/main/README.md#organization) <p align="center">
A maintained collective of different IR files for the <a href="https://flipperzero.one/">Flipper Zero</a>!
</p>
Maintainers/Major contributors include:
* [Lucaslhm](https://github.com/Lucaslhm) (*[Maintained Repo](https://github.com/Lucaslhm/Flipper-IRDB)*)
* [UberGuidoZ](https://github.com/UberGuidoZ) (*[Maintained Fork](https://github.com/UberGuidoZ/Flipper-IRDB)*)
* [ezod](https://github.com/ezod) (*[Maintained Fork](https://github.com/logickworkshop/Flipper-IRDB)*)
* [amec0e](https://github.com/amec0e)
* [darmiel](https://github.com/darmiel)
* [DedHedZed](https://github.com/dedhedzed)
* [SkeletonMan](https://github.com/SkeletonMan03/)
* [Seall.DEV](https://github.com/sealldeveloper)
* [jaroslavmraz](https://github.com/jaroslavmraz)
* [E_Surge](https://github.com/ESurge)
* [Zecred](https://github.com/bussardrobbie)
* [wdoekes](https://github.com/wdoekes)
* ... plus MANY others!
## Make your own manually! ## Installation
### Method 1: Copy Files to SD Card
Directly copying the .ir files to the Flipper's SD card is the fastest and safest method, but you have to [dismount the SD card](https://docs.flipperzero.one/basics/sd-card#g4-removing-the-sd-card) and plug it into the computer directly.
1. [Download and extract](https://github.com/logickworkshop/Flipper-IRDB/archive/refs/heads/main.zip) or [Git-clone](https://docs.github.com/en/repositories/creating-and-managing-repositories/cloning-a-repository) this repo to your computer.
2. Open the downloaded / cloned repository in a File Explorer.
3. [Dismount the SD card](https://docs.flipperzero.one/basics/sd-card#g4-removing-the-sd-card) from the Flipper and mount it to your computer
4. Copy the desired files from the Flipper-IRDB to the `infrared/` folder on your SD Card
5. Dismount the SD card from your computer and mount it to your Flipper
### Method 2: Copy Files using [QFlipper](https://flipperzero.one/update)
> [!IMPORTANT]
> Because of Flipper limitations, the transfer via QFlipper can take a long time, depending on how many files you want to copy.
> If you only want to copy several files, this will work fine, but if you want to load the entire Flipper-IRDB onto your Flipper, **we strongly recommend copying the files directly onto the SD card**.
1. [Git-clone](https://docs.github.com/en/repositories/creating-and-managing-repositories/cloning-a-repository) or [Download and extract](https://github.com/logickworkshop/Flipper-IRDB/archive/refs/heads/main.zip) this repository to your computer.
2. Connect your Flipper to your PC using a USB-C cable.
3. Open [QFlipper](https://flipperzero.one/update)
4. Verify that your Flipper shows "Connected"
5. Ensure your Flipper is fully up-to-date:
1. Look for the green "Update" button near the middle-right of the application.
2. Press "Update" and allow the Flipper to complete the Update process and then reboot before continuing.
6. Open the File Manager by selecting the "File Manager" icon (piece of paper) on the top left of the QFlipper application.
7. Select `SD Card`, then navigate to the `infrared` folder by double-clicking its icon.
8. Drag the downloaded `.ir` files you want on your Flipper from the File Explorer into the QFlipper File Manager.
## Contributing
We welcome contributions to Flipper-IRDB!
If you have any IR files that are not included in the repository, **we would love to have your additions**.
This repo is organized in the following fashion in descending order:
> `Device Type` > `Device Brand` > `Device Series` (if known/applicable)
When adding remotes to this repo, it is helpful to ensure your device name(s) follow the `<brand>_<model>.ir` naming scheme.
It is also helpful to ensure your model numbers are capitalized, as per the following examples:
* :white_check_mark: `LG_55UN7300AUD.ir`
* :x: `LG_55UN7300AUD.txt` (wrong extension)
* :x: `lg_55un7300aud.ir` (model numbers not capitalized)
* :x: `tv.ir` (too generic)
It's helpful to add further information as a comment directly into the IR file if possible.
Make, model, link, or even a short description can be helpful if the name is changed
(or just in general).
```bash
Filetype: IR signals file
Version: 1
#
# Dynex EN-21669D TV <--
#
name: Power
```
### Naming Scheme
Please use this naming scheme for buttons.
This helps us create universal assets more easily and maintain cosistency.
| TVs | Audio | ACs |
| --------- | -------- | --------- |
| `Power` | `Power` | `Off` |
| `Vol_up` | `Vol_up` | `Cool_hi` |
| `Vol_dn` | `Vol_dn` | `Cool_lo` |
| `Ch_next` | `Next` | `Heat_hi` |
| `Ch_prev` | `Prev` | `Heat_lo` |
| `Mute` | `Mute` | `Dh` |
| | `Play` | |
| | `Pause` | |
Did you know IR files are plain text files? If a remote is missing, you might be able to [make it manually](https://github.com/RandomDebugError/irdb).
## Universal Remotes ## Universal Remotes
The maintainers (mostly amec0e) add individual additions to the various Universal Remotes in Unleashed, which are adapted by many other firmware options. If you would like to contribute to the Universal Remotes, please make sure to follow the naming convention below. For ACs, [this is an important read](https://github.com/flipperdevices/flipperzero-firmware/blob/dev/documentation/UniversalRemotes.md). The maintainers (mostly [amec0e](https://github.com/amec0e)) add individual additions to the various Universal Remotes in [unleashed-firmware](https://github.com/DarkFlippers/unleashed-firmware), which are adapted by many other firmware options.
If you would like to contribute to the Universal Remotes, please make sure to follow the [naming scheme](#naming-scheme) above.
For ACs, [this is an important read](https://github.com/flipperdevices/flipperzero-firmware/blob/dev/documentation/UniversalRemotes.md).
## Organization
This repo is organized in the following fashion in descending order: ## Make your own manually!
* Device Type
* Device Brand
* Device Series (Where known/applicable)
When adding remotes to this repo, it is helpful to ensure your device name(s) follow the `brand_model.ir` naming scheme. It is also helpful to ensure your model numbers are capitalized, as per the following example: Did you know IR files are plain text files?
If a remote is missing, you might be able to [make it manually](https://github.com/RandomDebugError/irdb).
`LG_55UN7300AUD.ir`
Please use this naming scheme for buttons. ## Maintainers
**FOR TV** Maintainers / Major contributors include:
Power<br> <table>
Mute<br> <tr>
Vol_up<br> <td align="center" valign="top" width="14.28%">
Ch_next<br> <a href="https://github.com/Lucaslhm">
Vol_dn<br> <img src="https://avatars.githubusercontent.com/Lucaslhm?v=3?s=100" width="100px;" alt="Lucaslhm" />
Ch_prev <br />
<sub><b>Lucaslhm</b>
</a>
</td>
<td align="center" valign="top" width="14.28%">
<a href="https://github.com/UberGuidoZ">
<img src="https://avatars.githubusercontent.com/UberGuidoZ?v=3?s=100" width="100px;" alt="UberGuidoZ" />
<br />
<sub><b>UberGuidoZ</b>
</a>
</td>
<td align="center" valign="top" width="14.28%">
<a href="https://github.com/ezod">
<img src="https://avatars.githubusercontent.com/ezod?v=3?s=100" width="100px;" alt="ezod" />
<br />
<sub><b>ezod</b>
</a>
</td>
<td align="center" valign="top" width="14.28%">
<a href="https://github.com/amec0e">
<img src="https://avatars.githubusercontent.com/amec0e?v=3?s=100" width="100px;" alt="amec0e" />
<br />
<sub><b>amec0e</b>
</a>
</td>
<td align="center" valign="top" width="14.28%">
<a href="https://github.com/darmiel">
<img src="https://avatars.githubusercontent.com/darmiel?v=3?s=100" width="100px;" alt="darmiel" />
<br />
<sub><b>darmiel</b>
</a>
</td>
<td align="center" valign="top" width="14.28%">
<a href="https://github.com/dedhedzed">
<img src="https://avatars.githubusercontent.com/dedhedzed?v=3?s=100" width="100px;" alt="dedhedzed" />
<br />
<sub><b>dedhedzed</b>
</a>
</td>
<td align="center" valign="top" width="14.28%">
<a href="https://github.com/SkeletonMan03">
<img src="https://avatars.githubusercontent.com/SkeletonMan03?v=3?s=100" width="100px;" alt="SkeletonMan03" />
<br />
<sub><b>SkeletonMan03</b>
</a>
</td>
</tr>
<tr>
<td align="center" valign="top" width="14.28%">
<a href="https://github.com/sealldeveloper">
<img src="https://avatars.githubusercontent.com/sealldeveloper?v=3?s=100" width="100px;" alt="sealldeveloper" />
<br />
<sub><b>sealldeveloper</b>
</a>
</td>
<td align="center" valign="top" width="14.28%">
<a href="https://github.com/jaroslavmraz">
<img src="https://avatars.githubusercontent.com/jaroslavmraz?v=3?s=100" width="100px;" alt="jaroslavmraz" />
<br />
<sub><b>jaroslavmraz</b>
</a>
</td>
<td align="center" valign="top" width="14.28%">
<a href="https://github.com/ESurge">
<img src="https://avatars.githubusercontent.com/ESurge?v=3?s=100" width="100px;" alt="ESurge" />
<br />
<sub><b>ESurge</b>
</a>
</td>
<td align="center" valign="top" width="14.28%">
<a href="https://github.com/bussardrobbie">
<img src="https://avatars.githubusercontent.com/bussardrobbie?v=3?s=100" width="100px;" alt="bussardrobbie" />
<br />
<sub><b>bussardrobbie</b>
</a>
</td>
<td align="center" valign="top" width="14.28%">
<a href="https://github.com/wdoekes">
<img src="https://avatars.githubusercontent.com/wdoekes?v=3?s=100" width="100px;" alt="wdoekes" />
<br />
<sub><b>wdoekes</b>
</a>
</td>
</tr>
</table>
**FOR AC** *plus MANY others!*
Off<br>
Cool_hi<br>
Cool_lo<br>
Heat_hi<br>
Heat_lo<br>
Dh
**FOR AUDIO**
Power<br>
Vol_up<br>
Vol_dn<br>
Mute<br>
Next<br>
Prev<br>
Play<br>
Pause
Lastly, it's helpful to add further information as a comment directly into the IR file if possible. Example:
`Filetype: IR signals file`<br>
`Version: 1`<br>
`#`<br>
`# Dynex EN-21669D TV` <---<br>
`#`<br>
`name: Power`<br>
Make, model, link, or even a short description can be helpful if the name is changed (or just in general)!
## To Install New Remotes On Your Flipper:
1. Git clone this repo to your local PC. [Multiple options are explained here](https://docs.github.com/en/repositories/creating-and-managing-repositories/cloning-a-repository).
2. Open the cloned repository in a File Explorer.
3. Connect your Flipper to your PC using a USB-C cable.
4. Open [QFlipper](https://flipperzero.one/update)
5. Verify that your Flipper shows "Connected"
6. Ensure your Flipper is fully up-to-date:
1. Look for the green "Update" button near the middle-right of the application.
2. Press "Update" and allow the Flipper to complete the Update process and then reboot before continuing.
7. Open the File Manager by selecting the "File Manager" icon (piece of paper) on the top left of the QFlipper application.
8. Select `SD Card`, then navigate to the `infrared` folder by double-clicking its icon.
9. Drag the .ir files you want on your Flipper from the File Explorer into the QFlipper File Manager.
10. Disconnect the Flipper from the PC and have fun!
NOTE: If you plan to copy them all, it's highly recommended to [dismount the SD card](https://docs.flipperzero.one/basics/sd-card#g4-removing-the-sd-card) and plug it into the computer directly.