Liv - Mega Hack 3.0

Meu time e eu escolhemos o desafio da Árvore Educação inserido no Mega Hack .

Nossa solução consiste em uma aplicação web que permite o usuário ler ou ouvir livros pelo aplicativo Whatsapp.

• Página inicial.

• Página do Livro Dom Casmurro de Machado de Assis.

Descrição

• Site

No site do Liv, o usuário escolhe o livro que deseja ler, digita o número do celular, a quantidade de capítulos que quer receber por dia, o horário que quer recebê-los e o formato de leitura desejado.

• Leitura no WhatsApp

O programa faz a leitura de um arquivo txt que contém o livro Dom Casmurro de Machado de Assis (escolhemos este livro para a demonstração). Após a leitura, o programa separa o livro em capítulos e envia esses capítulos pelo WhatsApp no formato de mensagem de texto. Cada uma das mensagens enviadas é um parágrafo do capítulo.

Obs.: O livro utilizado foi encontrado no formato de pdf nesta página do Ministério da Educação e foi convertido para a extensão txt utilizando esta ferramenta online.

• Audiobook no Whatsapp

O programa acessa o Whatsapp, entra em um grupo específico do livro escolhido e encaminha, ao usuário que solicitou, o áudio.

Obs. 1: O grupo referido acima é feito dentro do aplicativo Whatsapp antes da execução do programa e contém o áudio do livro.

Obs. 2: O áudio utilizado pode ser encontrado nesta página .

Obs. 3: A parte da solução responsável por converter os livros em mensagens de texto e áudios no Whatsapp foi escrita na linguagem Python e usa a biblioteca Selenium como base.

Como funciona?

O usuário entra no site, escolhe o livro que quer ler, opta por áudio ou mensagem de texto, cadastra o número de celular e recebe o livro no formato escolhido em seu celular. Para mais detalhes acesse esse vídeo de demonstração.

Instalação

É preciso ter o Python instalado no seu computador (Python , recomendado baixar a última versão). Para importar algumas funções usadas nesse projeto é preciso fazer a instalação de uma biblioteca:

• selenium - Forma de instalação: pip install selenium

Obs 01.: É também necessário o uso do ChromeDriver 83.0.4103.39 que pode ser baixado nesta página . Ele deve ser inserido na mesma pasta do projeto, entretanto ele já está inserido neste repositório.

Uso

Após as instalações, para começar usar é preciso clonar esse repositório e seguir alguns parâmetros que serão passados pela linha de comando (terminal):

• Para receber o livro como mensagem de texto:

  • python enviaMensagemTexto.py -c <Número do Capítulo> -n <Nome do usuário que você enviará o livro (tem que ser exatamente igual ao que está no WhatsApp)>

    Exemplo: python enviaMensagemTexto.py -c 19 -n João

    Obs.: Para demonstração, utilizamos o livro Dom Casmurro, que possui 148 capítulos, por isso, escolha um capítulo inserido no intervalo de 1 a 148.

• Para receber o livro como audiobook:

  • Para o programa funcionar é necessário que previamente um grupo no Whatsapp seja criado com exatamente o nome "Dom Casmurro - Machado A." e neste grupo deve ser colocado o MP3 que pode ser encontrado aqui.

  • python enviaAudio.py -n <Nome do usuário que você enviará o livro (tem que ser exatamente igual ao que está no WhatsApp)>

    Exemplo: python enviaMensagemTexto.py -n João

Time

• Luiza Lissandra - Graduanda de Engenharia Eletrônica e de Computação na UFRJ.

• Isabela Zamith - Graduanda de Design de Mídia Digital na PUC-Rio.

• Iuri Almeida - Graduando de Engenharia Agrícola e Ambiental na UFF.

• Rômulo Cabral - Graduando de Engenharia de Computação na UERJ.

• Luiz Felipe - Graduando de Engenharia de Automação e Controle na UFRJ.